VkPipelineBinaryInfoKHR(3)

# VkPipelineBinaryInfoKHR(3) Manual Page

## Name

VkPipelineBinaryInfoKHR - Structure specifying pipeline binaries to use during pipeline creation

## C Specification

The `VkPipelineBinaryInfoKHR` structure is defined as:

    // Provided by VK_KHR_pipeline_binary
    typedef struct VkPipelineBinaryInfoKHR {
        VkStructureType               sType;
        const void*                   pNext;
        uint32_t                      binaryCount;
        const VkPipelineBinaryKHR*    pPipelineBinaries;
    } VkPipelineBinaryInfoKHR;

## Members

- `sType` is a VkStructureType value identifying this structure.

- `pNext` is `NULL` or a pointer to a structure extending this structure.

- `binaryCount` is the number of elements in the `pPipelineBinaries` array.

- `pPipelineBinaries` is a pointer to an array of VkPipelineBinaryKHR handles.

## Description

If a `VkPipelineBinaryInfoKHR` structure with a `binaryCount` greater than 0 is included in the `pNext` chain of any `Vk*PipelineCreateInfo` structure when creating a pipeline, implementations must use the data in `pPipelineBinaries` instead of recalculating it. Any shader module identifiers, shader modules, or chained VkShaderModuleCreateInfo structures declared in VkPipelineShaderStageCreateInfo instances, are ignored. Any VkShaderDescriptorSetAndBindingMappingInfoEXT in the `pNext` chains of VkPipelineShaderStageCreateInfo instances are ignored.

If this structure is not included in the `pNext` chain, it is equivalent to specifying this structure with a `binaryCount` of `0`.

Valid Usage

- VUID-VkPipelineBinaryInfoKHR-binaryCount-09603
  `binaryCount` and the order of the elements in `pPipelineBinaries` must exactly match that returned by vkCreatePipelineBinariesKHR for the matching `Vk*PipelineCreateInfo` structure and its `pNext` chain, ignoring the presence of the `VkPipelineBinaryInfoKHR` structure, the presence of the VK_PIPELINE_CREATE_2_CAPTURE_DATA_BIT_KHR flag, and absence of any shader module identifiers, shader modules, or `VkShaderModuleCreateInfo` structures, for the same global pipeline key, from either:

  - VkPipelineBinaryCreateInfoKHR::`pPipelineCreateInfo`, or

  - VkPipelineBinaryCreateInfoKHR::`pipeline`

Valid Usage (Implicit)

- VUID-VkPipelineBinaryInfoKHR-sType-sType
  `sType` must be VK_STRUCTURE_TYPE_PIPELINE_BINARY_INFO_KHR

- VUID-VkPipelineBinaryInfoKHR-pPipelineBinaries-parameter
  If `binaryCount` is not `0`, `pPipelineBinaries` must be a valid pointer to an array of `binaryCount` valid VkPipelineBinaryKHR handles

Structure Chaining

Extends the structures

  - VkComputePipelineCreateInfo

  - VkGraphicsPipelineCreateInfo

  - VkRayTracingPipelineCreateInfoKHR

## See Also

VK_KHR_pipeline_binary, VkPipelineBinaryKHR, VkStructureType

## Document Notes

For more information, see the Vulkan Specification.

This page is extracted from the Vulkan Specification. Fixes and changes should be made to the Specification, not directly.

## Copyright

Copyright 2014-2026 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0