> ## 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

> Descreve detalhes da operação de descarte de recurso.

Descreve detalhes da operação de descarte de recurso.

## Sintaxe

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

### Membros

*NumRects*\
Tipo: UINT

O número de retângulos na matriz especificada pelo membro **pRects**.

*pRects*\
Tipo: const D3D12\_RECT \*

Uma matriz de estruturas **D3D12\_RECT** para os retângulos do recurso a serem descartados.
Se for **NULL**, [DiscardResource](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_discardresource_public) descartará o recurso inteiro.

*FirstSubresource*\
Tipo: UINT

Índice do primeiro sub-recurso do recurso a ser descartado.

*NumSubresources*\
Tipo: UINT

O número de sub-recursos do recurso a serem descartados.

## Comentários

Esta estrutura é usada pelo método [ID3D12GraphicsCommandList::DiscardResource](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_discardresource_public).

Se forem fornecidos retângulos nesta estrutura, o recurso deverá ter sub-recursos 2D, e todos os sub-recursos especificados deverão ter a mesma dimensão.

## Requisitos

**Cabeçalho:** d3d12\_xs.h ou d3d12\_x.h\
**Biblioteca:** d3d12\_xs.lib ou d3d12\_x.lib\
**Plataformas com suporte**: consoles XBOX Series e família XBOX One

## Confira também

[Estruturas principais](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/direct3d-12-structures)


## Related topics

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