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

> Descreve um valor usado para otimizar operações de limpeza para um recurso específico.

Descreve um valor usado para otimizar operações de limpeza para um recurso específico.

## Sintaxe

```cpp theme={null}
typedef struct D3D12_CLEAR_VALUE
{
    DXGI_FORMAT Format;
    FLOAT Color;
    D3D12_DEPTH_STENCIL_VALUE DepthStencil;
} D3D12_CLEAR_VALUE
```

### Membros

*Format*\
Tipo: DXGI\_FORMAT

Especifica um membro da enumeração [DXGI\_FORMAT](https://learn.microsoft.com/en-us/windows/desktop/api/dxgiformat/ne-dxgiformat-dxgi_format).

O formato da cor de limpeza comumente usada segue as mesmas regras de validação que a criação de uma exibição/descritor. Em geral, o formato da cor de limpeza pode ser qualquer formato no mesmo grupo sem tipo ao qual o formato do recurso pertence.

Esse *Format* deve corresponder ao formato da exibição usada durante a operação de limpeza. Ele indica se o membro *Color* ou *DepthStencil* é válido e como converter os valores para uso com o recurso.

*Color*\
Tipo: FLOAT\[4]

Especifica uma matriz de 4 entradas de valores float, que determina o valor RGBA. A ordem de RGBA corresponde à ordem usada com [ClearRenderTargetView](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList/methods/id3d12graphicscommandlist_clearrendertargetview_xs).

*DepthStencil*\
Tipo: D3D12\_DEPTH\_STENCIL\_VALUE

Especifica um membro de [D3D12\_DEPTH\_STENCIL\_VALUE](/pt-BR/reference/graphics/d3d12/structs/d3d12_depth_stencil_value_public). Esses valores correspondem à semântica de *Depth* e *Stencil* em [ClearDepthStencilView](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_cleardepthstencilview_public).

## Comentários

Essa estrutura é passada opcionalmente para os seguintes métodos:

<ul>
  <li>
    [ID3D12Device::CreateCommittedResource](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createcommittedresource_public)
  </li>

  <li>
    [ID3D12Device::CreatePlacedResource](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createplacedresource_public)
  </li>

  <li>
    [ID3D12Device::CreateReservedResource](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createreservedresource_public)
  </li>
</ul>

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

[CD3DX12\_CLEAR\_VALUE](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/cd3dx12-clear-value)

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


## Related topics

- [D3D12_RENDER_PASS_BEGINNING_ACCESS_CLEAR_PARAMETERS](/pt-BR/reference/graphics/d3d12/structs/d3d12_render_pass_beginning_access_clear_parameters_public.md)
- [D3D12_DEPTH_STENCIL_VALUE](/pt-BR/reference/graphics/d3d12/structs/d3d12_depth_stencil_value_public.md)
- [CreateReservedResource](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createreservedresource_public.md)
- [CreateReservedResource1 (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device4/methods/id3d12device4_createreservedresource1_public.md)
- [CreateReservedResource2 (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device10/methods/id3d12device10_createreservedresource2_public.md)