ID3D12DebugCommandList1 ::AssertResourceState, méthode (d3d12sdklayers.h)

  • Article

Vérifie que l’état donné correspond à l’état de la sous-ressource, en supposant que l’état de la sous-ressource donnée est connu lors de l’enregistrement d’une liste de commandes (par exemple, la ressource a été transférée précédemment dans le même enregistrement de liste de commandes). Si l’état n’est pas encore connu, cette méthode définit l’état connu pour une validation ultérieure dans le même enregistrement de liste de commandes.

Syntaxe

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

Paramètres

[in] pResource

Type : ID3D12Resource*

Spécifie l’ID3D12Resource à case activée.

Subresource

Type : UINT

Index de la sous-ressource à case activée. Il peut s’agir d’un index ou d’un D3D12_RESOURCE_BARRIER_ALL_SUBRESOURCES.

State

Type : UINT

Spécifie l’état pour lequel case activée. Il peut s’agir d’un ou de plusieurs indicateurs D3D12_RESOURCE_STATES Ou’ed ensemble.

Valeur retournée

Type : BOOL

Cette méthode retourne true si l’état suivi de la ressource ou de la sous-ressource correspond à l’état spécifié, false dans le cas contraire.

Remarques

Étant donné que l’exécution des listes de commandes se produit quelque temps après l’enregistrement, l’état d’une ressource ne peut souvent pas être connu lors de l’enregistrement de la liste de commandes. AssertResourceState permet au développeur d’applications d’imposer un état supposé sur une ressource ou une sous-ressource à un point d’enregistrement fixe dans une liste de commandes.

Souvent, l’état d’une ressource ou d’une sous-ressource peut être connu en raison d’un obstacle précédent ou déduit par utilisation (par exemple, a été utilisé dans un appel antérieur à CopyBufferRegion) lors de l’enregistrement de la liste de commandes. Dans ce cas , AssertResourceState peut produire un message de débogage si l’état donné ne correspond pas à l’état connu ou supposé.

Cette API est destinée à la validation de débogage uniquement et n’affecte pas l’état réel du runtime ou du GPU de la ressource.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête d3d12sdklayers.h

Voir aussi

ID3D12DebugCommandList1