VkGraphicsPipelineLibraryCreateInfoEXT(3)

# VkGraphicsPipelineLibraryCreateInfoEXT(3) Manual Page

## Name

VkGraphicsPipelineLibraryCreateInfoEXT - Structure specifying the subsets of the graphics pipeline being compiled

## C Specification

The `VkGraphicsPipelineLibraryCreateInfoEXT` structure is defined as:

    // Provided by VK_EXT_graphics_pipeline_library
    typedef struct VkGraphicsPipelineLibraryCreateInfoEXT {
        VkStructureType                      sType;
        const void*                          pNext;
        VkGraphicsPipelineLibraryFlagsEXT    flags;
    } VkGraphicsPipelineLibraryCreateInfoEXT;

## Members

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

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

- `flags` is a bitmask of VkGraphicsPipelineLibraryFlagBitsEXT specifying the subsets of the graphics pipeline that are being compiled.

## Description

If a `VkGraphicsPipelineLibraryCreateInfoEXT` structure is included in the `pNext` chain of VkGraphicsPipelineCreateInfo, it specifies the subsets of the graphics pipeline being created, excluding any subsets from linked pipeline libraries. If the pipeline is created with pipeline libraries, state from those libraries is aggregated with said subset.

If this structure is omitted, and either VkGraphicsPipelineCreateInfo::`flags` includes VK_PIPELINE_CREATE_LIBRARY_BIT_KHR or the VkGraphicsPipelineCreateInfo::`pNext` chain includes a VkPipelineLibraryCreateInfoKHR structure with a `libraryCount` greater than `0`, it is as if `flags` is `0`. Otherwise if this structure is omitted, it is as if `flags` includes all possible subsets of the graphics pipeline (i.e. a complete graphics pipeline).

Valid Usage (Implicit)

- VUID-VkGraphicsPipelineLibraryCreateInfoEXT-sType-sType
  `sType` must be VK_STRUCTURE_TYPE_GRAPHICS_PIPELINE_LIBRARY_CREATE_INFO_EXT

- VUID-VkGraphicsPipelineLibraryCreateInfoEXT-flags-parameter
  `flags` must be a valid combination of VkGraphicsPipelineLibraryFlagBitsEXT values

- VUID-VkGraphicsPipelineLibraryCreateInfoEXT-flags-requiredbitmask
  `flags` must not be `0`

Structure Chaining

Extends the structure

  - VkGraphicsPipelineCreateInfo

## See Also

VK_EXT_graphics_pipeline_library, VkGraphicsPipelineLibraryFlagsEXT, 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