D3D12DDI_BARRIER_SUBRESOURCE_RANGE_0088 structure (d3d12umddi.h)

Important

Some information relates to a prerelease product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

The D3D12DDI_BARRIER_SUBRESOURCE_RANGE_0088 structure specifies the range of subresources being transitioned.

Syntax

typedef struct D3D12DDI_BARRIER_SUBRESOURCE_RANGE_0088 {
  UINT32 IndexOrFirstMipLevel;
  UINT32 NumMipLevels;
  UINT32 FirstArraySlice;
  UINT32 NumArraySlices;
  UINT32 FirstPlane;
  UINT32 NumPlanes;
} D3D12DDI_BARRIER_SUBRESOURCE_RANGE_0088;

Members

IndexOrFirstMipLevel

If NumMipLevels is zero, IndexOrFirstMipLevel specifies a subresource index. A subresource index of 0xffffffff can be used to specify all subresources.

If NumMipLevels is not zero, IndexOrFirstMipLevel identifies the first mip level in the range.

NumMipLevels

The number of mip levels in the range, or zero to indicate IndexOrFirstMipLevel is a subresource index.

FirstArraySlice

Index of the first array slice in the range. FirstArraySlice is ignored if NumMipLevels is zero.

NumArraySlices

Number of array slices in the range. NumArraySlices is ignored if NumMipLevels is zero.

FirstPlane

The first plane slice in the range. FirstPlane is ignored if NumMipLevels is zero.

NumPlanes

The number of plane slices in the range. NumPlanes is ignored if NumMipLevels is zero.

Remarks

The D3D12DDI_BARRIER_SUBRESOURCE_RANGE_0088 structure allows developers to transition a range of subresources such as a full mip-chain for a given texture array or a single mip-level for all array slices. The Enhanced Barriers feature allows developers to transition logically-adjacent ranges of subresources using this structure.

See Enhanced Barriers for general information.

Requirements

Requirement	Value
Minimum supported client	Windows 11 (WDDM 3.0)
Header	d3d12umddi.h

See also

D3D12DDI_RANGED_BARRIER_0088

D3D12DDI_TEXTURE_BARRIER_0088