Skip to main content

jay_ash/extensions/nv/
device_diagnostic_checkpoints.rs

1//! <https://registry.khronos.org/vulkan/specs/1.3-extensions/man/html/VK_NV_device_diagnostic_checkpoints.html>
2
3use crate::vk;
4use core::ffi;
5use core::mem;
6use core::ptr;
7
8impl crate::nv::device_diagnostic_checkpoints::Device {
9    /// <https://registry.khronos.org/vulkan/specs/1.3-extensions/man/html/vkCmdSetCheckpointNV.html>
10    #[inline]
11    pub unsafe fn cmd_set_checkpoint(
12        &self,
13        command_buffer: vk::CommandBuffer,
14        p_checkpoint_marker: *const ffi::c_void,
15    ) {
16        unsafe {
17            (self.fp.cmd_set_checkpoint_nv)(command_buffer, p_checkpoint_marker);
18        }
19    }
20
21    /// Retrieve the number of elements to pass to [`get_queue_checkpoint_data()`][Self::get_queue_checkpoint_data()]
22    #[inline]
23    pub unsafe fn get_queue_checkpoint_data_len(&self, queue: vk::Queue) -> usize {
24        unsafe {
25            let mut count = mem::MaybeUninit::uninit();
26            (self.fp.get_queue_checkpoint_data_nv)(queue, count.as_mut_ptr(), ptr::null_mut());
27            count.assume_init() as usize
28        }
29    }
30
31    /// <https://registry.khronos.org/vulkan/specs/1.3-extensions/man/html/vkGetQueueCheckpointDataNV.html>
32    ///
33    /// Call [`get_queue_checkpoint_data_len()`][Self::get_queue_checkpoint_data_len()] to query the number of elements to pass to `out`.
34    /// Be sure to [`Default::default()`]-initialize these elements and optionally set their `p_next` pointer.
35    #[inline]
36    pub unsafe fn get_queue_checkpoint_data(
37        &self,
38        queue: vk::Queue,
39        out: &mut [vk::CheckpointDataNV<'_>],
40    ) {
41        unsafe {
42            let mut count = out.len() as u32;
43            (self.fp.get_queue_checkpoint_data_nv)(queue, &mut count, out.as_mut_ptr());
44            assert_eq!(count as usize, out.len());
45        }
46    }
47}