ID3D11DeviceContext1::D iscardView1-Methode (d3d11_1.h)
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 |