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 :Configuration requise
En-tête : d3d12_xs.h ou d3d12_x.hBibliothèque : d3d12_xs.lib ou d3d12_x.lib
Plateformes prises en charge : consoles XBOX Series et famille XBOX One
