C Specification

The VkSamplerCustomBorderColorIndexCreateInfoEXT structure is defined as:

// Provided by VK_EXT_custom_border_color with VK_EXT_descriptor_heap
typedef struct VkSamplerCustomBorderColorIndexCreateInfoEXT {
    VkStructureType    sType;
    const void*        pNext;
    uint32_t           index;
} VkSamplerCustomBorderColorIndexCreateInfoEXT;

Members

  • sType is a VkStructureType value identifying this structure.

  • pNext is NULL or a pointer to a structure extending this structure.

  • index is the uint32_t index value to use with the sampler

Description

If this structure is included in the pNext chain of VkSamplerCreateInfo, the value of index will be used for the custom border color registration. index does not need to be registered at the point that a sampler object is created or a sampler descriptor is written; as long as it is registered when any use of the sampler is recorded to a command, and remains registered while the sampler is in use. The color registered with the index and the color specified in the sampler must be identically defined.

If this structure is not provided when creating a sampler object with a custom border color, it is equivalent to registering a new custom border color by calling vkRegisterCustomBorderColorEXT with that custom border color value, and using that value as index in this structure. This implicit registration will be implicitly unregistered when the sampler is destroyed.

If this structure is not provided when creating a sampler object without a custom border color, it is equivalent to setting index to 0.

Valid Usage
Valid Usage (Implicit)

See Also

VK_EXT_custom_border_color, VK_EXT_descriptor_heap, 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