Pular para o conteúdo principal
Indica a reutilização da memória associada ao alocador de comandos.

Sintaxe

Parâmetros

Valor retornado

Tipo: HRESULT Este método retornará E_FAIL se houver uma lista de comandos em gravação ativa que referencie o alocador de comandos. A camada de depuração também emitirá um erro nesse caso. Consulte Códigos de retorno do Direct3D 12 para outros valores de retorno possíveis.

Comentários

Os aplicativos chamam Reset para reutilizar a memória associada a um alocador de comandos. A partir dessa chamada para Reset, o runtime e o driver determinam que a unidade de processamento gráfico (GPU) não está mais executando nenhuma lista de comandos que tenha gravado comandos com o alocador de comandos. Ao contrário de ID3D12GraphicsCommandList::Reset, não é recomendado chamar Reset no alocador de comandos enquanto uma lista de comandos ainda estiver sendo executada. A camada de depuração emitirá um aviso se não puder comprovar que não há referências pendentes da GPU a listas de comandos que gravaram comandos no alocador. A camada de depuração emitirá um erro se Reset for chamado simultaneamente por vários threads (no mesmo objeto alocador).

Exemplos

O exemplo D3D12HelloTriangle usa ID3D12CommandAllocator::Reset da seguinte maneira:
Consulte o Código de exemplo na referência do D3D12.

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

ID3D12CommandAllocator
Última modificação em 6 de outubro de 2026