Function Prototype
vkCreateSamplerYcbcrConversion
Create a new {YCbCr} conversion
To create a VkSamplerYcbcrConversion, call:
VkResult vkCreateSamplerYcbcrConversion(
VkDevice device,
const VkSamplerYcbcrConversionCreateInfo* pCreateInfo,
const VkAllocationCallbacks* pAllocator,
VkSamplerYcbcrConversion* pYcbcrConversion);
pub fn create_sampler_ycbcr_conversion(
device: vk::Device,
p_create_info: *const vk::SamplerYcbcrConversionCreateInfo,
p_allocator: *const vk::AllocationCallbacks,
p_ycbcr_conversion: *mut vk::SamplerYcbcrConversion,
) -> vk::Result;
VkResult vkCreateSamplerYcbcrConversionKHR(
VkDevice device,
const VkSamplerYcbcrConversionCreateInfo* pCreateInfo,
const VkAllocationCallbacks* pAllocator,
VkSamplerYcbcrConversion* pYcbcrConversion);
pub fn create_sampler_ycbcr_conversion_khr(
device: vk::Device,
p_create_info: *const vk::SamplerYcbcrConversionCreateInfo,
p_allocator: *const vk::AllocationCallbacks,
p_ycbcr_conversion: *mut vk::SamplerYcbcrConversion,
) -> vk::Result;
deviceis the logical device that creates the sampler Y′CBCR conversion.pCreateInfois a pointer to a VkSamplerYcbcrConversionCreateInfo structure specifying the requested sampler Y′CBCR conversion.pAllocatorcontrols host memory allocation as described in the Memory Allocation chapter.pYcbcrConversionis a pointer to a VkSamplerYcbcrConversion handle in which the resulting sampler Y′CBCR conversion is returned.
The interpretation of the configured sampler Y′CBCR conversion is described in more detail in the description of sampler Y′CBCR conversion in the Image Operations chapter.
Valid Usage
VUID-vkCreateSamplerYcbcrConversion-None-01648
The samplerYcbcrConversion
feature must be enabled
Valid Usage (Implicit)
VUID-vkCreateSamplerYcbcrConversion-device-parameter
device must be a valid VkDevice handle
VUID-vkCreateSamplerYcbcrConversion-pCreateInfo-parameter
pCreateInfo must be a valid pointer to a valid VkSamplerYcbcrConversionCreateInfo structure
VUID-vkCreateSamplerYcbcrConversion-pAllocator-parameter
If pAllocator is not NULL, pAllocator must be a valid pointer to a valid VkAllocationCallbacks structure
VUID-vkCreateSamplerYcbcrConversion-pYcbcrConversion-parameter
pYcbcrConversion must be a valid pointer to a VkSamplerYcbcrConversion handle
Parent
VK_VERSION_1_1Type
Function Prototype
Return Values
VK_SUCCESS
VK_ERROR_OUT_OF_HOST_MEMORY
VK_ERROR_OUT_OF_DEVICE_MEMORY
VK_ERROR_UNKNOWN
VK_ERROR_VALIDATION_FAILED