=================== HLSL Resource Types

.. contents:: :local:

Introduction

HLSL Resources are runtime-bound data that is provided as input, output or both to shader programs written in HLSL. Resource Types in HLSL provide key user abstractions for reading and writing resource data.

Implementation Details

In Clang resource types are forward declared by the HLSLExternalSemaSource on initialization. They are then lazily completed when requiresCompleteType is called later in Sema.

Resource types are classes that have the "intangible" resource handle type, __hlsl_resource_t, as a member. These are generally templated class declarations that specify the type of data that can be loaded from or stored into the resource. The handle is annotated with hlsl-specific attributes describing properties of the resource. Member functions of a resource type are generally fairly simple wrappers around builtins that operate on the handle member.

During code generation resource types are lowered to target extension types in IR. These types are target specific and differ between DXIL and SPIR-V generation, providing the necessary information for the targets to generate binding metadata for their respective target runtimes.