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:

Valid Usage (Implicit)

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