Metodo ID3D12DebugCommandList1::AssertResourceState (d3d12sdklayers.h)

Verifica che lo stato specificato corrisponda allo stato della sottoresource, presupponendo che lo stato della sottoresource specificata sia noto durante la registrazione di un elenco di comandi, ad esempio la risorsa è stata passata in precedenza nella stessa registrazione dell'elenco di comandi. Se lo stato non è ancora noto questo metodo imposta lo stato noto per ulteriori convalida più avanti nella stessa registrazione dell'elenco di comandi.

Sintassi

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

Parametri

[in] pResource

Tipo: ID3D12Resource*

Specifica l'ID3D12Resource da controllare.

Subresource

Tipo: UINT

Indice della sottoresource da controllare. È possibile impostare su un indice o D3D12_RESOURCE_BARRIER_ALL_SUBRESOURCES.

State

Tipo: UINT

Specifica lo stato da controllare. Questo può essere uno o più flag D3D12_RESOURCE_STATES O'ed insieme.

Valore restituito

Tipo: BOOL

Questo metodo restituisce true se lo stato monitorato della risorsa o della sottoresource corrisponde allo stato specificato, false in caso contrario.

Commenti

Poiché l'esecuzione degli elenchi di comandi si verifica dopo la registrazione, lo stato di una risorsa spesso non può essere noto durante la registrazione dell'elenco di comandi. AssertResourceState offre a uno sviluppatore di applicazioni la possibilità di imporre uno stato assunto su una risorsa o su una sottoresource in un punto di registrazione fisso in un elenco di comandi.

Spesso lo stato di una risorsa o di una sottoresource può essere noto a causa di una barriera precedente o di un uso dedotto (ad esempio, è stato usato in una chiamata precedente a CopyBufferRegion) durante la registrazione dell'elenco di comandi. In questi casi AssertResourceState può produrre un messaggio di debug se lo stato specificato non corrisponde allo stato noto o assunto.

Questa API è solo per la convalida di debug e non influisce sullo stato effettivo del runtime o della GPU della risorsa.

Requisiti

Vedi anche

ID3D12DebugCommandList1