Share via


ID3D11DeviceContext1 ::D iscardView1, méthode (d3d11_1.h)

Ignore les éléments spécifiés dans une vue de ressources à partir du contexte de l’appareil.

Syntaxe

void DiscardView1(
  [in]           ID3D11View       *pResourceView,
  [in, optional] const D3D11_RECT *pRects,
                 UINT             NumRects
);

Paramètres

[in] pResourceView

Type : ID3D11View*

Pointeur vers l’interface ID3D11View pour l’affichage des ressources à ignorer. La ressource qui sous-tend l’affichage doit avoir été créée avec l’utilisation D3D11_USAGE_DEFAULT ou D3D11_USAGE_DYNAMIC, sinon le runtime supprime l’appel à DiscardView1 ; si la couche de débogage est activée, le runtime retourne un message d’erreur.

[in, optional] pRects

Type : const D3D11_RECT*

Tableau de structures D3D11_RECT pour les rectangles dans l’affichage de ressources à ignorer. Si la valeur est NULL, DiscardView1 ignore l’ensemble de la vue et se comporte de la même façon que DiscardView.

NumRects

Type : UINT

Nombre de rectangles dans le tableau spécifié par le paramètre pRects .

Valeur de retour

None

Remarques

DiscardView1 informe l’unité de traitement graphique (GPU) que le contenu existant dans les éléments spécifiés dans la vue de ressources vers lequel pointe pResourceView n’est plus nécessaire. La vue peut être un SRV, RTV, UAV ou DSV. DiscardView1 est une variante de la méthode DiscardResource . DiscardView1 vous permet d’ignorer les éléments d’un sous-ensemble d’une ressource qui se trouve dans une vue (par exemple, les éléments d’un seul miplevel). Plus important encore, DiscardView1 offre une commodité, car les affichages sont souvent des éléments qui sont liés et non liés au niveau du pipeline. Certaines liaisons de pipeline n’ont pas de vues, telles que la sortie de flux. Dans ce cas, DiscardResource peut effectuer le travail pour n’importe quelle ressource.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8 et mise à jour de plateforme pour Windows 7 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2012 et mise à jour de plateforme pour Windows Server 2008 R2 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête d3d11_1.h
Bibliothèque D3D11.lib

Voir aussi

ID3D11DeviceContext1