Share via

Método ID3D12DebugCommandList1::AssertResourceState (d3d12sdklayers.h)

  • Artigo

Valida se o estado especificado corresponde ao estado do sub-recurso, supondo que o estado do sub-recurso especificado seja conhecido durante a gravação de uma lista de comandos (por exemplo, o recurso foi transferido anteriormente na mesma gravação de lista de comandos). Se o estado ainda não for conhecido, esse método definirá o estado conhecido para validação posteriormente na mesma gravação de lista de comandos.

Sintaxe

BOOL AssertResourceState(
  [in] ID3D12Resource *pResource,
       UINT           Subresource,
       UINT           State
);

Parâmetros

[in] pResource

Tipo: ID3D12Resource*

Especifica a ID3D12Resource a ser marcar.

Subresource

Tipo: UINT

O índice do sub-recurso a ser marcar. Isso pode ser definido como um índice ou D3D12_RESOURCE_BARRIER_ALL_SUBRESOURCES.

State

Tipo: UINT

Especifica o estado para o qual marcar. Pode ser um ou mais sinalizadores D3D12_RESOURCE_STATES ou juntos.

Retornar valor

Tipo: BOOL

Esse método retornará true se o estado rastreado do recurso ou da sub-fonte corresponder ao estado especificado, caso contrário, false .

Comentários

Como a execução de listas de comandos ocorre algum tempo após a gravação, o estado de um recurso geralmente não pode ser conhecido durante a gravação da lista de comandos. AssertResourceState dá a um desenvolvedor de aplicativos a capacidade de impor um estado assumido em um recurso ou sub-recurso em um ponto de gravação fixo em uma lista de comandos.

Geralmente, o estado de um recurso ou sub-recurso pode ser conhecido devido a uma barreira anterior ou inferido por uso (por exemplo, foi usado em uma chamada anterior para CopyBufferRegion) durante a gravação da lista de comandos. Nesses casos, AssertResourceState poderá produzir uma mensagem de depuração se o estado especificado não corresponder ao estado conhecido ou assumido.

Essa API destina-se apenas à validação de depuração e não afeta o tempo de execução real ou o estado de GPU do recurso.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho d3d12sdklayers.h

Confira também

ID3D12DebugCommandList1