Syntaxe
Paramètres
DepthStencilView [in]Type : D3D12_CPU_DESCRIPTOR_HANDLE Décrit le handle de descripteur de processeur qui représente le début du tas pour le gabarit de profondeur à 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 est 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 la valeur est NULL, ClearDepthStencilView efface toute la vue de ressource.
Valeur de retour
Type : void Aucune.Remarques
Seules les listes de commandes directes et les listes de commandes groupées (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 à 0 (tout en préservant les NAN). Un échec de validation fait en sorte que l’appel à Close retourne E_INVALIDARG.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
