D3D12_DISCARD_REGION structure (d3d12.h)

Describes details for the discard-resource operation.

Syntax

typedef struct D3D12_DISCARD_REGION {
  UINT             NumRects;
  const D3D12_RECT *pRects;
  UINT             FirstSubresource;
  UINT             NumSubresources;
} D3D12_DISCARD_REGION;

Members

NumRects

The number of rectangles in the array that the pRects member specifies.

pRects

An array of D3D12_RECT structures for the rectangles in the resource to discard. If NULL, DiscardResource discards the entire resource.

FirstSubresource

Index of the first subresource in the resource to discard.

NumSubresources

The number of subresources in the resource to discard.

Remarks

This structure is used by the ID3D12GraphicsCommandList::DiscardResource method.

If rectangles are supplied in this structure, the resource must have 2D subresources with all specified subresources the same dimension.

Requirements

Requirement Value
Header d3d12.h

See also

Core Structures