D3D12DDI_RESOURCE_STATES enumeration (d3d12umddi.h)

Article
05/24/2022

Contains resource states. Resource barriers allow transitioning between hardware specific states for a corresponding operation and to synchronize read after write. Resource barriers are an existing concept in D3D12 that is extended to support video decode and video process by adding these usage flags.

Syntax

typedef enum D3D12DDI_RESOURCE_STATES {
  D3D12DDI_RESOURCE_STATE_COMMON = 0x00000000,
  D3D12DDI_RESOURCE_STATE_VERTEX_AND_CONSTANT_BUFFER = 0x00000001,
  D3D12DDI_RESOURCE_STATE_INDEX_BUFFER = 0x00000002,
  D3D12DDI_RESOURCE_STATE_RENDER_TARGET = 0x00000004,
  D3D12DDI_RESOURCE_STATE_UNORDERED_ACCESS = 0x00000008,
  D3D12DDI_RESOURCE_STATE_DEPTH_WRITE = 0x00000010,
  D3D12DDI_RESOURCE_STATE_DEPTH_READ = 0x00000020,
  D3D12DDI_RESOURCE_STATE_NON_PIXEL_SHADER_RESOURCE = 0x00000040,
  D3D12DDI_RESOURCE_STATE_PIXEL_SHADER_RESOURCE = 0x00000080,
  D3D12DDI_RESOURCE_STATE_STREAM_OUT = 0x00000100,
  D3D12DDI_RESOURCE_STATE_INDIRECT_ARGUMENT = 0x00000200,
  D3D12DDI_RESOURCE_STATE_COPY_DEST = 0x00000400,
  D3D12DDI_RESOURCE_STATE_COPY_SOURCE = 0x00000800,
  D3D12DDI_RESOURCE_STATE_RESOLVE_DEST = 0x00001000,
  D3D12DDI_RESOURCE_STATE_RESOLVE_SOURCE = 0x00002000,
  D3D12DDI_RESOURCE_STATE_0020_VIDEO_DECODE_READ = 0x00010000,
  D3D12DDI_RESOURCE_STATE_0020_VIDEO_DECODE_WRITE = 0x00020000,
  D3D12DDI_RESOURCE_STATE_0020_VIDEO_PROCESS_READ = 0x00040000,
  D3D12DDI_RESOURCE_STATE_0020_VIDEO_PROCESS_WRITE = 0x00080000,
  D3D12DDI_RESOURCE_STATE_0060_VIDEO_ENCODE_READ = 0x00200000,
  D3D12DDI_RESOURCE_STATE_0060_VIDEO_ENCODE_WRITE = 0x00800000,
  D3D12DDI_RESOURCE_STATE_0062_SHADING_RATE_SOURCE = 0x01000000,
  D3D12DDI_RESOURCE_STATE_RAYTRACING_ACCELERATION_STRUCTURE = 0x400000
} ;

Constants


`D3D12DDI_RESOURCE_STATE_COMMON` Value: 0x00000000 Common.
`D3D12DDI_RESOURCE_STATE_VERTEX_AND_CONSTANT_BUFFER` Value: 0x00000001 Vertex and constant buffer.
`D3D12DDI_RESOURCE_STATE_INDEX_BUFFER` Value: 0x00000002 Index buffer.
`D3D12DDI_RESOURCE_STATE_RENDER_TARGET` Value: 0x00000004 Render target.
`D3D12DDI_RESOURCE_STATE_UNORDERED_ACCESS` Value: 0x00000008 Unordered access.
`D3D12DDI_RESOURCE_STATE_DEPTH_WRITE` Value: 0x00000010 Depth write.
`D3D12DDI_RESOURCE_STATE_DEPTH_READ` Value: 0x00000020 Depth read.
`D3D12DDI_RESOURCE_STATE_NON_PIXEL_SHADER_RESOURCE` Value: 0x00000040 Non-pixel shader resource.
`D3D12DDI_RESOURCE_STATE_PIXEL_SHADER_RESOURCE` Value: 0x00000080 Pixel shader resource.
`D3D12DDI_RESOURCE_STATE_STREAM_OUT` Value: 0x00000100 Stream out.
`D3D12DDI_RESOURCE_STATE_INDIRECT_ARGUMENT` Value: 0x00000200 Indirect argument.
`D3D12DDI_RESOURCE_STATE_COPY_DEST` Value: 0x00000400 Copy destination.
`D3D12DDI_RESOURCE_STATE_COPY_SOURCE` Value: 0x00000800 Copy source.
`D3D12DDI_RESOURCE_STATE_RESOLVE_DEST` Value: 0x00001000 Resolve destination.
`D3D12DDI_RESOURCE_STATE_RESOLVE_SOURCE` Value: 0x00002000 Resolve source.
`D3D12DDI_RESOURCE_STATE_0020_VIDEO_DECODE_READ` Value: 0x00010000 Video decode read. The read state is used for reading references during decode and also used for inputs to process frame. This state is only valid in the decode and process command list.
`D3D12DDI_RESOURCE_STATE_0020_VIDEO_DECODE_WRITE` Value: 0x00020000 Video decode write. The write state is used for the decode target, or destination surface of the process frame. The write state is also used when decode conversion is enabled for the non-converted reference. This state is only valid in the decode and process command list.
`D3D12DDI_RESOURCE_STATE_0020_VIDEO_PROCESS_READ` Value: 0x00040000 Video process read.
`D3D12DDI_RESOURCE_STATE_0020_VIDEO_PROCESS_WRITE` Value: 0x00080000 Video process write.
`D3D12DDI_RESOURCE_STATE_0060_VIDEO_ENCODE_READ` Value: 0x00200000 Video encode read resource state.
`D3D12DDI_RESOURCE_STATE_0060_VIDEO_ENCODE_WRITE` Value: 0x00800000 Video encode write resource state.
`D3D12DDI_RESOURCE_STATE_0062_SHADING_RATE_SOURCE` Value: 0x01000000 Shading rate source resource state. Available starting in WDDM 2.6.
`D3D12DDI_RESOURCE_STATE_RAYTRACING_ACCELERATION_STRUCTURE` Value: 0x400000 Ray tracing acceleration structure resource state.

Remarks

Resource barriers allow transitioning between hardware specific states for a corresponding operation and to synchronize read after write.

Resource barriers are an existing concept in D3D12 that is extended to support video decode by adding new usage flags. The write state is used for the decode target. The write state is also used when decode conversion is enabled for the non-converted reference.

Requirements

Requirement	Value
Minimum UMDF version	Direct3D 12.0
Header	d3d12umddi.h (include D3d12umddi.h)