ID3D11DeviceContext1::D iscardView1-Methode (d3d11_1.h)

  • Artikel

Verwirft die angegebenen Elemente in einer Ressourcenansicht aus dem Gerätekontext.

Syntax

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

Parameter

[in] pResourceView

Typ: ID3D11View*

Ein Zeiger auf die ID3D11View-Schnittstelle für die zu verwerfende Ressourcenansicht. Die Ressource, die der Ansicht zugrunde liegende ist, muss mit Verwendung D3D11_USAGE_DEFAULT oder D3D11_USAGE_DYNAMIC erstellt worden sein. Andernfalls verwirft die Laufzeit den Aufruf von DiscardView1. Wenn die Debugebene aktiviert ist, gibt die Runtime eine Fehlermeldung zurück.

[in, optional] pRects

Typ: const D3D11_RECT*

Ein Array von D3D11_RECT Strukturen für die zu verwerfenden Rechtecke in der Ressourcenansicht. Bei NULL verwirft DiscardView1 die gesamte Ansicht und verhält sich genauso wie DiscardView.

NumRects

Typ: UINT

Anzahl der Rechtecke im Array, das der pRects-Parameter angibt.

Rückgabewert

Keine

Bemerkungen

DiscardView1 informiert die Grafikverarbeitungseinheit (GPU), dass der vorhandene Inhalt in den angegebenen Elementen in der Ressourcenansicht, auf die pResourceView verweist, nicht mehr benötigt wird. Die Ansicht kann eine SRV, RTV, UAV oder DSV sein. DiscardView1 ist eine Variante der DiscardResource-Methode . Mit DiscardView1 können Sie Elemente einer Teilmenge einer Ressource verwerfen, die sich in einer Ansicht befindet (z. B. Elemente eines einzelnen miplevels). Noch wichtiger ist, dass DiscardView1 einen Komfort bietet, da Ansichten häufig an die Pipeline gebunden und aufgehoben werden. Einige Pipelinebindungen verfügen nicht über Ansichten, z. B. die Streamausgabe. In diesem Fall kann DiscardResource den Auftrag für jede Ressource ausführen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile d3d11_1.h
Bibliothek D3D11.lib

Weitere Informationen

ID3D11DeviceContext1