Function Prototype
vkCreatePipelineBinariesKHR
Create pipeline binaries from a pipeline or previously retrieved data
To create pipeline binary objects, call:
VkResult vkCreatePipelineBinariesKHR(
VkDevice device,
const VkPipelineBinaryCreateInfoKHR* pCreateInfo,
const VkAllocationCallbacks* pAllocator,
VkPipelineBinaryHandlesInfoKHR* pBinaries);
pub fn create_pipeline_binaries_khr(
device: vk::Device,
p_create_info: *const vk::PipelineBinaryCreateInfoKHR,
p_allocator: *const vk::AllocationCallbacks,
p_binaries: *mut vk::PipelineBinaryHandlesInfoKHR,
) -> vk::Result;
deviceis the logical device that creates the pipeline binary objects.pCreateInfois a pointer to a VkPipelineBinaryCreateInfoKHR structure that contains the data to create the pipeline binaries from.pAllocatorcontrols host memory allocation as described in the Memory Allocation chapter.pBinariesis a pointer to a VkPipelineBinaryHandlesInfoKHR structure in which the resulting pipeline binaries are returned.
The implementation will attempt to create all pipeline binaries. If creation fails for any pipeline binary, then:
- The corresponding entry in the
pPipelineBinariesoutput array will be filled with VK_NULL_HANDLE. - The
VkResultreturned by vkCreatePipelineBinariesKHR will contain the error value for the first entry in the output array inpBinariescontaining VK_NULL_HANDLE.
Valid Usage (Implicit)
VUID-vkCreatePipelineBinariesKHR-device-parameter
device must be a valid VkDevice handle
VUID-vkCreatePipelineBinariesKHR-pCreateInfo-parameter
pCreateInfo must be a valid pointer to a valid VkPipelineBinaryCreateInfoKHR structure
VUID-vkCreatePipelineBinariesKHR-pAllocator-parameter
If pAllocator is not NULL, pAllocator must be a valid pointer to a valid VkAllocationCallbacks structure
VUID-vkCreatePipelineBinariesKHR-pBinaries-parameter
pBinaries must be a valid pointer to a VkPipelineBinaryHandlesInfoKHR structure
Parent
VK_KHR_pipeline_binaryType
Function Prototype
Return Values
VK_SUCCESS
VK_INCOMPLETE
VK_PIPELINE_BINARY_MISSING_KHR
VK_ERROR_OUT_OF_HOST_MEMORY
VK_ERROR_OUT_OF_DEVICE_MEMORY
VK_ERROR_INITIALIZATION_FAILED
VK_ERROR_UNKNOWN
VK_ERROR_VALIDATION_FAILED