Skip to main content
Describes details for the discard-resource operation.

Syntax

Members

NumRects
Type: UINT
The number of rectangles in the array that the pRects member specifies. pRects
Type: const D3D12_RECT *
An array of D3D12_RECT structures for the rectangles in the resource to discard. If NULL, DiscardResource discards the entire resource. FirstSubresource
Type: UINT
Index of the first subresource in the resource to discard. NumSubresources
Type: UINT
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

Header: d3d12_xs.h or d3d12_x.h
Library: d3d12_xs.lib or d3d12_x.lib
Supported Platforms: XBOX Series consoles and XBOX One family

See Also

Core Structures
Last modified on August 20, 2026