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);
device
is the logical device that creates the pipeline binary objects.pCreateInfo
is a pointer to a VkPipelineBinaryCreateInfoKHR structure that contains the data to create the pipeline binaries from.pAllocator
controls host memory allocation as described in the Memory Allocation chapter.pBinaries
is 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
pPipelineBinaries
output array will be filled with VK_NULL_HANDLE. - The
VkResult
returned by vkCreatePipelineBinariesKHR will contain the error value for the first entry in the output array inpBinaries
containing 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