> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# D3D12_DISCARD_REGION

> 描述捨棄資源作業的詳細資料。

描述捨棄資源作業的詳細資料。

## 語法

```cpp theme={null}
typedef struct D3D12_DISCARD_REGION
{
    UINT NumRects;
    const D3D12_RECT  pRects;
    UINT FirstSubresource;
    UINT NumSubresources;
} D3D12_DISCARD_REGION
```

### 成員

*NumRects*\
類型：UINT

**pRects** 成員所指定之陣列中的矩形數目。

*pRects*\
類型：const D3D12\_RECT \*

**D3D12\_RECT** 結構的陣列，代表資源中要捨棄的矩形。
如果為 **NULL**，[DiscardResource](/zh-TW/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_discardresource_public) 會捨棄整個資源。

*FirstSubresource*\
類型：UINT

資源中要捨棄之第一個子資源的索引。

*NumSubresources*\
類型：UINT

資源中要捨棄的子資源數目。

## 備註

此結構由 [ID3D12GraphicsCommandList::DiscardResource](/zh-TW/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_discardresource_public) 方法使用。

如果此結構中提供了矩形，資源必須具有 2D 子資源，且所有指定的子資源都具有相同的維度。

## 需求

**標頭:** d3d12\_xs.h 或 d3d12\_x.h\
**程式庫:** d3d12\_xs.lib 或 d3d12\_x.lib\
**支援的平台**: XBOX Series 主機與 XBOX One 系列

## 另請參閱

[核心結構](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/direct3d-12-structures)


## Related topics

- [D3D12_MIP_REGION](/zh-TW/reference/graphics/d3d12/structs/d3d12_mip_region_public.md)
- [D3D12_TILE_REGION_SIZE](/zh-TW/reference/graphics/d3d12/structs/d3d12_tile_region_size_public.md)
- [D3D12_BOX](/zh-TW/reference/graphics/d3d12/structs/d3d12_box_public.md)
- [D3D12_RESOLVE_MODE](/zh-TW/reference/graphics/d3d12/enums/d3d12_resolve_mode_public.md)
- [D3D12_RESOURCE_DESC1](/zh-TW/reference/graphics/d3d12/structs/d3d12_resource_desc1_public.md)