Syntaxe
Paramètres
RenderTargetView [in]Type : D3D12_CPU_DESCRIPTOR_HANDLE Spécifie une structure D3D12_CPU_DESCRIPTOR_HANDLE qui décrit le handle de descripteur CPU représentant le début du tas pour la cible de rendu à effacer. ColorRGBA [in]
Type : const FLOAT[4] Tableau à 4 composantes qui représente la couleur avec laquelle remplir la cible de rendu. 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 correspondant aux rectangles de la vue de ressource à effacer. Si la valeur est NULL, ClearRenderTargetView efface la totalité de la vue de ressource.
Valeur de retour
Type : void Aucune.Remarques
ClearRenderTargetView peut être utilisé pour initialiser des ressources qui partagent par alias la même mémoire de tas. Pour plus d’informations, consultez CreatePlacedResource.Notes propres à XBOX
Le fait de transmettre la valeur -1 pour le paramètre RectCount et nullptr pour le paramètre pRects active une opération d’effacement spéciale destinée à des configurations spécifiques de cibles de rendu MSAA. Cet effacement spécial efface uniquement la surface de métadonnées DCC d’une cible de rendu MSAA 4x ou 8x qui utilise DCC mais pas le masque de fragment (FMask). Cet effacement spécial a pour effet de n’effacer que les échantillons 0-1, en laissant les échantillons 2 et supérieurs non initialisés.Validation du runtime
Pour les entrées à virgule flottante, le runtime définit les valeurs dénormalisées sur 0 (tout en conservant les NAN). Un échec de validation entraîne le retour 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 ClearRenderTargetView, l’état doit être D3D12_RESOURCE_STATE_RENDER_TARGET.Configuration requise
En-tête : d3d12_xs.hBibliothèque : d3d12_xs.lib
Plateformes prises en charge : consoles XBOX Series