ash/extensions/khr/
get_surface_capabilities2.rs

1//! <https://registry.khronos.org/vulkan/specs/1.3-extensions/man/html/VK_KHR_get_surface_capabilities2.html>
2
3use crate::prelude::*;
4use crate::vk;
5use core::mem;
6use core::ptr;
7
8impl crate::khr::get_surface_capabilities2::Instance {
9    /// <https://registry.khronos.org/vulkan/specs/1.3-extensions/man/html/vkGetPhysicalDeviceSurfaceCapabilities2KHR.html>
10    #[inline]
11    pub unsafe fn get_physical_device_surface_capabilities2(
12        &self,
13        physical_device: vk::PhysicalDevice,
14        surface_info: &vk::PhysicalDeviceSurfaceInfo2KHR<'_>,
15        surface_capabilities: &mut vk::SurfaceCapabilities2KHR<'_>,
16    ) -> VkResult<()> {
17        (self.fp.get_physical_device_surface_capabilities2_khr)(
18            physical_device,
19            surface_info,
20            surface_capabilities,
21        )
22        .result()
23    }
24
25    /// Retrieve the number of elements to pass to [`get_physical_device_surface_formats2()`][Self::get_physical_device_surface_formats2()]
26    #[inline]
27    pub unsafe fn get_physical_device_surface_formats2_len(
28        &self,
29        physical_device: vk::PhysicalDevice,
30        surface_info: &vk::PhysicalDeviceSurfaceInfo2KHR<'_>,
31    ) -> VkResult<usize> {
32        let mut count = mem::MaybeUninit::uninit();
33        let err_code = (self.fp.get_physical_device_surface_formats2_khr)(
34            physical_device,
35            surface_info,
36            count.as_mut_ptr(),
37            ptr::null_mut(),
38        );
39        err_code.assume_init_on_success(count).map(|c| c as usize)
40    }
41
42    /// <https://registry.khronos.org/vulkan/specs/1.3-extensions/man/html/vkGetPhysicalDeviceSurfaceFormats2KHR.html>
43    ///
44    /// Call [`get_physical_device_surface_formats2_len()`][Self::get_physical_device_surface_formats2_len()] to query the number of elements to pass to `out`.
45    /// Be sure to [`Default::default()`]-initialize these elements and optionally set their `p_next` pointer.
46    #[inline]
47    pub unsafe fn get_physical_device_surface_formats2(
48        &self,
49        physical_device: vk::PhysicalDevice,
50        surface_info: &vk::PhysicalDeviceSurfaceInfo2KHR<'_>,
51        out: &mut [vk::SurfaceFormat2KHR<'_>],
52    ) -> VkResult<()> {
53        let mut count = out.len() as u32;
54        let err_code = (self.fp.get_physical_device_surface_formats2_khr)(
55            physical_device,
56            surface_info,
57            &mut count,
58            out.as_mut_ptr(),
59        );
60        assert_eq!(count as usize, out.len());
61        err_code.result()
62    }
63}