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

# ResetX (consoles XBOX Series)

> ResetX (consoles XBOX Series) — Redefine uma lista de comandos para seu estado inicial, como se uma nova lista de comandos tivesse acabado de ser criada. Referência gráfica do Direct3D 12 para XBOX.

Redefine uma lista de comandos para seu estado inicial, como se uma nova lista de comandos tivesse acabado de ser criada.

## Sintaxe

```cpp theme={null}
HRESULT ResetX(  
         ID3D12CommandAllocator* pAllocator,  
         ID3D12PipelineState* pInitialState,  
         D3D12XBOX_COMMAND_LIST_RESET_FLAGS Flags  
)  
```

### Parâmetros

*pAllocator*   \_In\_\
Tipo: [ID3D12CommandAllocator](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/nn-d3d12-id3d12commandallocator)\*

Um ponteiro para o objeto **ID3D12CommandAllocator** que define o alocador de comandos.

*pInitialState*   \_In\_opt\_\
Tipo: [ID3D12PipelineState](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/nn-d3d12-id3d12pipelinestate)\*

Um ponteiro para um objeto **ID3D12PipelineState** que define o estado inicial do pipeline.

*Flags*   \_In\_\
Tipo: [D3D12XBOX\_COMMAND\_LIST\_RESET\_FLAGS](/pt-BR/reference/graphics/d3d12_xs/enums/d3d12xbox_command_list_reset_flags)

Sinalizadores de extensão do XBOX para a redefinição da lista de comandos.

### Valor retornado

Tipo: HRESULT

Retorna S\_OK se bem-sucedido; caso contrário, retorna um código de erro. Para obter uma lista de códigos de erro, consulte [Códigos de retorno do Direct3D 12](https://learn.microsoft.com/en-us/windows/win32/direct3d12/d3d12-graphics-reference-returnvalues).

## Comentários

Para obter mais informações sobre listas de comandos e alocadores de comandos, consulte [Criando e gravando listas de comandos e bundles](https://learn.microsoft.com/en-us/windows/win32/direct3d12/recording-command-lists-and-bundles#creating-command-lists).

Passe o sinalizador [D3D12XBOX\_COMMAND\_LIST\_RESET\_FLAGS\_MINIMAL\_STATE](/pt-BR/reference/graphics/d3d12_xs/enums/d3d12xbox_command_list_reset_flags) para evitar que o estado padrão seja gravado na lista durante a redefinição.

* Observação:
  Ao executar listas de comandos, a primeira lista de comandos na matriz **não** pode ter sido redefinida com o sinalizador [D3D12XBOX\_COMMAND\_LIST\_RESET\_FLAGS\_MINIMAL\_STATE](/pt-BR/reference/graphics/d3d12_xs/enums/d3d12xbox_command_list_reset_flags).

## Requisitos

**Cabeçalho:** d3d12\_xs.h\
**Biblioteca:** d3d12\_xs.lib\
**Plataformas compatíveis**: consoles XBOX Series

## Confira também

[ID3D12GraphicsCommandList6](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList6/id3d12graphicscommandlist6)


## Related topics

- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr-CA/nda/nda-topic-directory.md)
- [Barrier (XBOX Series consoles)](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist7/methods/id3d12graphicscommandlist7_barrier_public.md)
- [PIX GPU Trace captures on XBOX Series consoles](/tools/tools-console/pix/gpu-trace/index.md)
- [DispatchRays (XBOX Series consoles)](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_dispatchrays_public.md)