VkLayerSettingEXT(3)

# VkLayerSettingEXT(3) Manual Page

## Name

VkLayerSettingEXT - Specify a layer capability to configure

Loading… please wait.

## C Specification

The values of elements of the VkLayerSettingsCreateInfoEXT::`pSettings` array, specifying layer settings to be configured, are:

    // Provided by VK_EXT_layer_settings
    typedef struct VkLayerSettingEXT {
        const char*              pLayerName;
        const char*              pSettingName;
        VkLayerSettingTypeEXT    type;
        uint32_t                 valueCount;
        const void*              pValues;
    } VkLayerSettingEXT;

## Members

- `pLayerName` is a pointer to a null-terminated UTF-8 string naming the layer to configure the setting from.

- `pSettingName` is a pointer to a null-terminated UTF-8 string naming the setting to configure. Unknown `pSettingName` by the layer are ignored.

- `type` is a VkLayerSettingTypeEXT value specifying the type of the `pValues` values.

- `count` is the number of values used to configure the layer setting.

- `pValues` is a pointer to an array of `count` values of the type indicated by `type` to configure the layer setting.

## Description

When multiple VkLayerSettingsCreateInfoEXT structures are chained and the same `pSettingName` is referenced for the same `pLayerName`, the value of the first reference of the layer setting is used.

Valid Usage (Implicit)

- VUID-VkLayerSettingEXT-pLayerName-parameter
  `pLayerName` must be a null-terminated UTF-8 string

- VUID-VkLayerSettingEXT-pSettingName-parameter
  `pSettingName` must be a null-terminated UTF-8 string

- VUID-VkLayerSettingEXT-type-parameter
  `type` must be a valid VkLayerSettingTypeEXT value

- VUID-VkLayerSettingEXT-pValues-parameter
  If `valueCount` is not `0`, `pValues` must be a valid pointer to an array of `valueCount` bytes

## See Also

VK_EXT_layer_settings, VkLayerSettingTypeEXT, VkLayerSettingsCreateInfoEXT

## 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-2024 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0