Realm

vk · Functions · Q1

13 public declarations with native signatures and source-owned contracts.

FnRustExperimental

Fnvk::queue_begin_debug_utils_label_ext

pub unsafe fn queue_begin_debug_utils_label_ext( device: &Device, queue: Queue, p_label_info: *const DebugUtilsLabelEXT<'_>, ) -> Result<(), CallError>
Call vkQueueBeginDebugUtilsLabelEXT using this context’s cached function pointer.

Contract

Call vkQueueBeginDebugUtilsLabelEXT using this context’s cached function pointer.

Errors

Reports a missing command or a negative native VkResult; non-error results are preserved.

Safety

The context and all handles must be live and belong to the same Vulkan implementation/device. Meet vkQueueBeginDebugUtilsLabelEXT valid usage, enabled API/extension/feature, pointer-chain lifetime, callback compatibility and host/GPU synchronization requirements. Native resources require explicit destruction after completion.

Preserves native raw pointers, explicit counts, optional nulls and return values. The caller supplies correctly aligned live storage, initialized output-chain headers and every extent implied by native counts, strides or nested records. No allocation, retry, output initialization, ownership transfer or alias fallback occurs in this wrapper. Outputs, including partial outputs on native failure, remain caller-owned and must be inspected/cleaned up according to Vulkan.

Khronos reference: vkQueueBeginDebugUtilsLabelEXT

Fnvk::queue_bind_sparse

pub unsafe fn queue_bind_sparse( device: &Device, queue: Queue, bind_info: &[BindSparseInfo<'_>], fence: Fence, ) -> Result<(), CallError>
Call vkQueueBindSparse using this context’s cached function pointer.

Contract

Call vkQueueBindSparse using this context’s cached function pointer.

Errors

Reports a missing command, invalid slice lengths/counts or a native error.

Safety

The context and all handles must be live and belong to the same Vulkan implementation/device. Meet vkQueueBindSparse valid usage, enabled API/extension/feature, pointer-chain lifetime, callback compatibility and host/GPU synchronization requirements. Native resources require explicit destruction after completion.

Khronos reference: vkQueueBindSparse

Fnvk::queue_end_debug_utils_label_ext

pub unsafe fn queue_end_debug_utils_label_ext( device: &Device, queue: Queue, ) -> Result<(), CallError>
Call vkQueueEndDebugUtilsLabelEXT using this context’s cached function pointer.

Contract

Call vkQueueEndDebugUtilsLabelEXT using this context’s cached function pointer.

Errors

Reports a missing command or a negative native VkResult; non-error results are preserved.

Safety

The context and all handles must be live and belong to the same Vulkan implementation/device. Meet vkQueueEndDebugUtilsLabelEXT valid usage, enabled API/extension/feature, pointer-chain lifetime, callback compatibility and host/GPU synchronization requirements. Native resources require explicit destruction after completion.

Preserves native raw pointers, explicit counts, optional nulls and return values. The caller supplies correctly aligned live storage, initialized output-chain headers and every extent implied by native counts, strides or nested records. No allocation, retry, output initialization, ownership transfer or alias fallback occurs in this wrapper. Outputs, including partial outputs on native failure, remain caller-owned and must be inspected/cleaned up according to Vulkan.

Khronos reference: vkQueueEndDebugUtilsLabelEXT

Fnvk::queue_insert_debug_utils_label_ext

pub unsafe fn queue_insert_debug_utils_label_ext( device: &Device, queue: Queue, p_label_info: *const DebugUtilsLabelEXT<'_>, ) -> Result<(), CallError>
Call vkQueueInsertDebugUtilsLabelEXT using this context’s cached function pointer.

Contract

Call vkQueueInsertDebugUtilsLabelEXT using this context’s cached function pointer.

Errors

Reports a missing command or a negative native VkResult; non-error results are preserved.

Safety

The context and all handles must be live and belong to the same Vulkan implementation/device. Meet vkQueueInsertDebugUtilsLabelEXT valid usage, enabled API/extension/feature, pointer-chain lifetime, callback compatibility and host/GPU synchronization requirements. Native resources require explicit destruction after completion.

Preserves native raw pointers, explicit counts, optional nulls and return values. The caller supplies correctly aligned live storage, initialized output-chain headers and every extent implied by native counts, strides or nested records. No allocation, retry, output initialization, ownership transfer or alias fallback occurs in this wrapper. Outputs, including partial outputs on native failure, remain caller-owned and must be inspected/cleaned up according to Vulkan.

Khronos reference: vkQueueInsertDebugUtilsLabelEXT

Fnvk::queue_notify_out_of_band_legacy_nv

pub unsafe fn queue_notify_out_of_band_legacy_nv( device: &Device, queue: Queue, queue_type: u32, ) -> Result<(), CallError>
Call vkQueueNotifyOutOfBandLegacyNV using this context’s cached function pointer.

Contract

Call vkQueueNotifyOutOfBandLegacyNV using this context’s cached function pointer.

Errors

Reports a missing command or a negative native VkResult; non-error results are preserved.

Safety

The context and all handles must be live and belong to the same Vulkan implementation/device. Meet vkQueueNotifyOutOfBandLegacyNV valid usage, enabled API/extension/feature, pointer-chain lifetime, callback compatibility and host/GPU synchronization requirements. Native resources require explicit destruction after completion.

Preserves native raw pointers, explicit counts, optional nulls and return values. The caller supplies correctly aligned live storage, initialized output-chain headers and every extent implied by native counts, strides or nested records. No allocation, retry, output initialization, ownership transfer or alias fallback occurs in this wrapper. Outputs, including partial outputs on native failure, remain caller-owned and must be inspected/cleaned up according to Vulkan.

Khronos reference: vkQueueNotifyOutOfBandLegacyNV

Fnvk::queue_notify_out_of_band_nv

pub unsafe fn queue_notify_out_of_band_nv( device: &Device, queue: Queue, p_queue_type_info: *const OutOfBandQueueTypeInfoNV<'_>, ) -> Result<(), CallError>
Call vkQueueNotifyOutOfBandNV using this context’s cached function pointer.

Contract

Call vkQueueNotifyOutOfBandNV using this context’s cached function pointer.

Errors

Reports a missing command or a negative native VkResult; non-error results are preserved.

Safety

The context and all handles must be live and belong to the same Vulkan implementation/device. Meet vkQueueNotifyOutOfBandNV valid usage, enabled API/extension/feature, pointer-chain lifetime, callback compatibility and host/GPU synchronization requirements. Native resources require explicit destruction after completion.

Preserves native raw pointers, explicit counts, optional nulls and return values. The caller supplies correctly aligned live storage, initialized output-chain headers and every extent implied by native counts, strides or nested records. No allocation, retry, output initialization, ownership transfer or alias fallback occurs in this wrapper. Outputs, including partial outputs on native failure, remain caller-owned and must be inspected/cleaned up according to Vulkan.

Khronos reference: vkQueueNotifyOutOfBandNV

Fnvk::queue_present_khr

pub unsafe fn queue_present_khr( device: &Device, queue: Queue, p_present_info: *const PresentInfoKHR<'_>, ) -> Result<Result, CallError>
Call vkQueuePresentKHR using this context’s cached function pointer.

Contract

Call vkQueuePresentKHR using this context’s cached function pointer.

Errors

Reports a missing command or a negative native VkResult; non-error results are preserved.

Safety

The context and all handles must be live and belong to the same Vulkan implementation/device. Meet vkQueuePresentKHR valid usage, enabled API/extension/feature, pointer-chain lifetime, callback compatibility and host/GPU synchronization requirements. Native resources require explicit destruction after completion.

Preserves native raw pointers, explicit counts, optional nulls and return values. The caller supplies correctly aligned live storage, initialized output-chain headers and every extent implied by native counts, strides or nested records. No allocation, retry, output initialization, ownership transfer or alias fallback occurs in this wrapper. Outputs, including partial outputs on native failure, remain caller-owned and must be inspected/cleaned up according to Vulkan.

Khronos reference: vkQueuePresentKHR

Fnvk::queue_set_perf_hint_qcom

pub unsafe fn queue_set_perf_hint_qcom( device: &Device, queue: Queue, p_perf_hint_info: *const PerfHintInfoQCOM<'_>, ) -> Result<Result, CallError>
Call vkQueueSetPerfHintQCOM using this context’s cached function pointer.

Contract

Call vkQueueSetPerfHintQCOM using this context’s cached function pointer.

Errors

Reports a missing command or a negative native VkResult; non-error results are preserved.

Safety

The context and all handles must be live and belong to the same Vulkan implementation/device. Meet vkQueueSetPerfHintQCOM valid usage, enabled API/extension/feature, pointer-chain lifetime, callback compatibility and host/GPU synchronization requirements. Native resources require explicit destruction after completion.

Preserves native raw pointers, explicit counts, optional nulls and return values. The caller supplies correctly aligned live storage, initialized output-chain headers and every extent implied by native counts, strides or nested records. No allocation, retry, output initialization, ownership transfer or alias fallback occurs in this wrapper. Outputs, including partial outputs on native failure, remain caller-owned and must be inspected/cleaned up according to Vulkan.

Khronos reference: vkQueueSetPerfHintQCOM

Fnvk::queue_set_performance_configuration_intel

pub unsafe fn queue_set_performance_configuration_intel( device: &Device, queue: Queue, configuration: PerformanceConfigurationINTEL, ) -> Result<Result, CallError>
Call vkQueueSetPerformanceConfigurationINTEL using this context’s cached function pointer.

Contract

Call vkQueueSetPerformanceConfigurationINTEL using this context’s cached function pointer.

Errors

Reports a missing command or a negative native VkResult; non-error results are preserved.

Safety

The context and all handles must be live and belong to the same Vulkan implementation/device. Meet vkQueueSetPerformanceConfigurationINTEL valid usage, enabled API/extension/feature, pointer-chain lifetime, callback compatibility and host/GPU synchronization requirements. Native resources require explicit destruction after completion.

Preserves native raw pointers, explicit counts, optional nulls and return values. The caller supplies correctly aligned live storage, initialized output-chain headers and every extent implied by native counts, strides or nested records. No allocation, retry, output initialization, ownership transfer or alias fallback occurs in this wrapper. Outputs, including partial outputs on native failure, remain caller-owned and must be inspected/cleaned up according to Vulkan.

Khronos reference: vkQueueSetPerformanceConfigurationINTEL

Fnvk::queue_submit

Contract

Submit command buffers to a queue.

Safety

All resources referenced by the command buffers must be live and not mutated by the host until the fence signals.

Khronos reference: vkQueueSubmit

Fnvk::queue_submit2

pub unsafe fn queue_submit2( device: &Device, queue: Queue, submits: &[SubmitInfo2<'_>], fence: Fence, ) -> Result<(), CallError>
Call vkQueueSubmit2 using this context’s cached function pointer.

Contract

Call vkQueueSubmit2 using this context’s cached function pointer.

Errors

Reports a missing command, invalid slice lengths/counts or a native error.

Safety

The context and all handles must be live and belong to the same Vulkan implementation/device. Meet vkQueueSubmit2 valid usage, enabled API/extension/feature, pointer-chain lifetime, callback compatibility and host/GPU synchronization requirements. Native resources require explicit destruction after completion.

Khronos reference: vkQueueSubmit2

Fnvk::queue_submit2_khr

pub unsafe fn queue_submit2_khr( device: &Device, queue: Queue, submits: &[SubmitInfo2<'_>], fence: Fence, ) -> Result<(), CallError>
Call vkQueueSubmit2KHR using this context’s cached function pointer.

Contract

Call vkQueueSubmit2KHR using this context’s cached function pointer.

Errors

Reports a missing command, invalid slice lengths/counts or a native error.

Safety

The context and all handles must be live and belong to the same Vulkan implementation/device. Meet vkQueueSubmit2KHR valid usage, enabled API/extension/feature, pointer-chain lifetime, callback compatibility and host/GPU synchronization requirements. Native resources require explicit destruction after completion.

Khronos reference: vkQueueSubmit2KHR

Fnvk::queue_wait_idle

Contract

Wait for a queue to become idle (all submitted work complete).

Safety

queue must be a live handle from this device.

Khronos reference: vkQueueWaitIdle