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

# ClearState

> Redefine o estado de uma lista de comandos direta para o estado em que ela estava quando foi criada. (ID3D12GraphicsCommandList.ClearState)

Redefine o estado de uma lista de comandos direta para o estado em que ela estava quando foi criada.

## Sintaxe

```cpp theme={null}
void ClearState(
    ID3D12PipelineState  pPipelineState
)
```

### Parâmetros

*pPipelineState \[in, optional]*\
Tipo: ID3D12PipelineState \*

Um ponteiro para o objeto [ID3D12PipelineState](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12PipelineState/id3d12pipelinestate_xs) que contém o estado de pipeline inicial da lista de comandos.

### Valor retornado

Tipo: void

Nenhum.

## Comentários

Não é válido chamar **ClearState** em um pacote.  Se um aplicativo chamar **ClearState** em um pacote, a chamada para [Close](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_close_public) retornará **E\_FAIL**.

Quando **ClearState** é chamado, todos os recursos associados no momento são desassociados.  A topologia primitiva é definida como [D3D\_PRIMITIVE\_TOPOLOGY\_UNDEFINED](https://learn.microsoft.com/en-us/windows/desktop/api/d3dcommon/ne-d3dcommon-d3d_primitive_topology).  Visores, retângulos de tesoura, valor de referência de estêncil e fator de mesclagem são definidos como valores vazios (todos zeros).  A predicação é desabilitada.

O objeto de estado de pipeline fornecido pelo aplicativo passa a ser associado como o objeto de estado de pipeline definido no momento.

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

[ID3D12GraphicsCommandList](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList/id3d12graphicscommandlist_xs)


## Related topics

- [D3D12_META_COMMAND_DESC](/pt-BR/reference/graphics/d3d12/structs/d3d12_meta_command_desc_public.md)
- [ClearUnorderedAccessViewFloat](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_clearunorderedaccessviewfloat_public.md)
- [ClearUnorderedAccessViewUint](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_clearunorderedaccessviewuint_public.md)
- [HCMockClearMocks](/pt-BR/reference/live/httpclient/mock/functions/hcmockclearmocks.md)
- [CreateCommittedResource](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createcommittedresource_public.md)