Skip to main content
Efface la ressource de profondeur-gabarit.

Syntaxe

Paramètres

DepthStencilView [in]
Type : D3D12_CPU_DESCRIPTOR_HANDLE
Décrit le handle de descripteur CPU qui représente le début du tas pour la profondeur-gabarit à effacer. ClearFlags [in]
Type : D3D12_CLEAR_FLAGS
Combinaison de valeurs D3D12_CLEAR_FLAGS combinées à l’aide d’une opération OR au niveau du bit. La valeur résultante identifie le type de données à effacer (tampon de profondeur, tampon de gabarit ou les deux). Depth [in]
Type : FLOAT
Valeur avec laquelle effacer le tampon de profondeur. Cette valeur sera limitée entre 0 et 1. Stencil [in]
Type : UINT8
Valeur avec laquelle effacer le tampon de gabarit. NumRects [in]
Type : UINT
Nombre de rectangles dans le tableau spécifié par le paramètre pRects. pRects [in]
Type : const D3D12_RECT*
Tableau de structures D3D12_RECT pour les rectangles de la vue de ressource à effacer. Si NULL, ClearDepthStencilView efface toute la vue de ressource.

Valeur renvoyée

Type : void Aucune.

Remarques

Seules les listes de commandes directes et les bundles prennent en charge cette opération. ClearDepthStencilView peut être utilisée pour initialiser des ressources qui partagent par alias la même mémoire de tas. Consultez CreatePlacedResource pour plus de détails.

Validation du runtime

Pour les entrées à virgule flottante, le runtime définit les valeurs dénormalisées sur 0 (tout en préservant les NAN).
Un échec de validation entraîne le renvoi de E_INVALIDARG par l’appel à Close.

Couche de débogage

La couche de débogage émet des erreurs si les couleurs d’entrée sont dénormalisées.
La couche de débogage émet une erreur si les sous-ressources référencées par la vue ne sont pas dans l’état approprié. Pour ClearDepthStencilView, l’état doit être D3D12_RESOURCE_STATE_DEPTH_WRITE.

Exemples

L’exemple D3D12Bundles utilise ID3D12GraphicsCommandList::ClearDepthStencilView comme suit :
L’exemple D3D12Multithreading utilise ID3D12GraphicsCommandList::ClearDepthStencilView comme suit :
Consultez Exemple de code dans la référence Direct3D 12.

Configuration requise

En-tête : d3d12_xs.h ou d3d12_x.h
Bibliothèque : d3d12_xs.lib ou d3d12_x.lib
Plateformes prises en charge : consoles XBOX Series et famille XBOX One

Voir aussi

ID3D12GraphicsCommandList
Last modified on October 6, 2026