Vulkan.Extensions.VK_VALVE_descriptor_set_host_mapping

Name

VK_VALVE_descriptor_set_host_mapping - device extension

VK_VALVE_descriptor_set_host_mapping

Name String

VK_VALVE_descriptor_set_host_mapping

Extension Type

Device extension

Registered Extension Number

421

Revision

1

Ratification Status

Not ratified

Extension and Version Dependencies

VK_KHR_get_physical_device_properties2

or

Vulkan Version 1.1

Special Use

• D3D support

Contact

• Hans-Kristian Arntzen @HansKristian-Work%0A*Here describe the issue or question you have about the VK_VALVE_descriptor_set_host_mapping extension*

Other Extension Metadata

Last Modified Date

2022-02-22

IP Status

No known IP claims.

Contributors

• Hans-Kristian Arntzen, Valve

Description

This extension allows applications to directly query a host pointer for a DescriptorSet which can be used to copy descriptors between descriptor sets without the use of an API command. Memory offsets and sizes for descriptors can be queried from a DescriptorSetLayout as well.

There is currently no specification language written for this extension. The links to APIs defined by the extension are to stubs that only include generated content such as API declarations and implicit valid usage statements.

This extension is only intended for use in specific embedded environments with known implementation details, and is therefore undocumented.

New Commands

• getDescriptorSetHostMappingVALVE

• getDescriptorSetLayoutHostMappingInfoVALVE

New Structures

• DescriptorSetBindingReferenceVALVE

• DescriptorSetLayoutHostMappingInfoVALVE

• Extending PhysicalDeviceFeatures2, DeviceCreateInfo:

  • PhysicalDeviceDescriptorSetHostMappingFeaturesVALVE

New Enum Constants

• VALVE_DESCRIPTOR_SET_HOST_MAPPING_EXTENSION_NAME

• VALVE_DESCRIPTOR_SET_HOST_MAPPING_SPEC_VERSION

• Extending StructureType:

  • STRUCTURE_TYPE_DESCRIPTOR_SET_BINDING_REFERENCE_VALVE

  • STRUCTURE_TYPE_DESCRIPTOR_SET_LAYOUT_HOST_MAPPING_INFO_VALVE

  • STRUCTURE_TYPE_PHYSICAL_DEVICE_DESCRIPTOR_SET_HOST_MAPPING_FEATURES_VALVE

Stub API References

There is currently no specification language written for this command. This section acts only as placeholder and to avoid dead links in the specification and reference pages.

// Provided by VK_VALVE_descriptor_set_host_mapping
void vkGetDescriptorSetLayoutHostMappingInfoVALVE(
    VkDevice                                    device,
    const VkDescriptorSetBindingReferenceVALVE* pBindingReference,
    VkDescriptorSetLayoutHostMappingInfoVALVE*  pHostMapping);

Valid Usage (Implicit)

• device must be a valid Device handle

• pBindingReference must be a valid pointer to a valid DescriptorSetBindingReferenceVALVE structure

• pHostMapping must be a valid pointer to a DescriptorSetLayoutHostMappingInfoVALVE structure

There is currently no specification language written for this command. This section acts only as placeholder and to avoid dead links in the specification and reference pages.

// Provided by VK_VALVE_descriptor_set_host_mapping
void vkGetDescriptorSetHostMappingVALVE(
    VkDevice                                    device,
    VkDescriptorSet                             descriptorSet,
    void**                                      ppData);

Valid Usage (Implicit)

• device must be a valid Device handle

• descriptorSet must be a valid DescriptorSet handle

• ppData must be a valid pointer to a pointer value

• descriptorSet must have been created, allocated, or retrieved from device

There is currently no specification language written for this type. This section acts only as placeholder and to avoid dead links in the specification and reference pages.

// Provided by VK_VALVE_descriptor_set_host_mapping
typedef struct VkPhysicalDeviceDescriptorSetHostMappingFeaturesVALVE {
    VkStructureType    sType;
    void*              pNext;
    VkBool32           descriptorSetHostMapping;
} VkPhysicalDeviceDescriptorSetHostMappingFeaturesVALVE;

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_PHYSICAL_DEVICE_DESCRIPTOR_SET_HOST_MAPPING_FEATURES_VALVE

Structure Chaining

Extends the structures

• DeviceCreateInfo

• PhysicalDeviceFeatures2

There is currently no specification language written for this type. This section acts only as placeholder and to avoid dead links in the specification and reference pages.

// Provided by VK_VALVE_descriptor_set_host_mapping
typedef struct VkDescriptorSetBindingReferenceVALVE {
    VkStructureType          sType;
    const void*              pNext;
    VkDescriptorSetLayout    descriptorSetLayout;
    uint32_t                 binding;
} VkDescriptorSetBindingReferenceVALVE;

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_DESCRIPTOR_SET_BINDING_REFERENCE_VALVE

• pNext must be NULL

• descriptorSetLayout must be a valid DescriptorSetLayout handle

There is currently no specification language written for this type. This section acts only as placeholder and to avoid dead links in the specification and reference pages.

// Provided by VK_VALVE_descriptor_set_host_mapping
typedef struct VkDescriptorSetLayoutHostMappingInfoVALVE {
    VkStructureType    sType;
    void*              pNext;
    size_t             descriptorOffset;
    uint32_t           descriptorSize;
} VkDescriptorSetLayoutHostMappingInfoVALVE;

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_DESCRIPTOR_SET_LAYOUT_HOST_MAPPING_INFO_VALVE

• pNext must be NULL

Version History

• Revision 1, 2022-02-22 (Hans-Kristian Arntzen)

  • Initial specification

See Also

No cross-references are available

Document Notes

For more information, see the Vulkan Specification.

This page is a generated document. Fixes and changes should be made to the generator scripts, not directly.