ID3D12GraphicsCommandList::D iscardResource, méthode (d3d12.h)

Article
08/23/2023

Indique que le contenu d’une ressource n’a pas besoin d’être conservé. La fonction peut réin initialiser les métadonnées de ressource dans certains cas.

Syntaxe

void DiscardResource(
  ID3D12Resource             *pResource,
  const D3D12_DISCARD_REGION *pRegion
);

Paramètres

pResource

Type : [in] ID3D12Resource*

Pointeur vers l’interface ID3D12Resource pour la ressource à ignorer.

pRegion

Type : [in, facultatif] const D3D12_DISCARD_REGION*

Pointeur vers une structure D3D12_DISCARD_REGION qui décrit les détails de l’opération discard-resource.

Valeur de retour

None

Notes

La sémantique de DiscardResource change en fonction du type de liste de commandes.

Pour D3D12_COMMAND_LIST_TYPE_DIRECT, les deux règles suivantes s’appliquent :

Lorsqu’une ressource a l’indicateur D3D12_RESOURCE_FLAG_ALLOW_RENDER_TARGET , DiscardResource doit être appelé lorsque les régions de sous-ressource ignorées sont dans l’état D3D12_RESOURCE_STATE_RENDER_TARGET barrière de ressources.
Lorsqu’une ressource a l’indicateur D3D12_RESOURCE_FLAG _ALLOW_DEPTH_STENCIL , DiscardResource doit être appelé lorsque les régions de sous-ressource ignorées se trouvent dans le D3D12_RESOURCE_STATE_DEPTH_WRITE.

Pour D3D12_COMMAND_LIST_TYPE_COMPUTE, la règle suivante s’applique :

La ressource doit avoir l’indicateur D3D12_RESOURCE_FLAG_ALLOW_UNORDERED_ACCESS , et DiscardResource doit être appelée lorsque les régions de sous-ressource ignorées sont dans l’état D3D12_RESOURCE_STATE_UNORDERED_ACCESS barrière de ressource.

DiscardResource n’est pas pris en charge sur les listes de commandes avec D3D12_COMMAND_LIST_TYPE_BUNDLE ni D3D12_COMMAND_LIST_TYPE_COPY.

Spécifications


Plateforme cible	Windows
En-tête	d3d12.h
Bibliothèque	D3d12.lib
DLL	D3d12.dll

Voir aussi

ID3D12GraphicsCommandList

Utilisation de barrières de ressources pour synchroniser les états des ressources dans Direct3D 12

Partager via