D3DDDIARG_CLEAR Struktur (d3dumddi.h)

Artikel
08/07/2023

Die D3DDDIARG_CLEAR-Struktur beschreibt die Parameter eines hardwaregestützten Clearingvorgangs.

Syntax

typedef struct _D3DDDIARG_CLEAR {
  [in] UINT  Flags;
  [in] UINT  FillColor;
  [in] FLOAT FillDepth;
  [in] UINT  FillStencil;
} D3DDDIARG_CLEAR;

Member

[in] Flags

Ein UINT-Wert, der angibt, welche Puffer der Treiber löschen soll und wie der Clear-Vorgang ausgeführt werden soll. Dieses Element kann ein bitweiser OR der folgenden Werte sein. Weitere Informationen finden Sie im Abschnitt Hinweise auf der Seite Verweis löschen .

Wert	Bedeutung
D3DCLEAR_TARGET (0x00000001l)	Der Treiber sollte das Renderziel des Kontexts auf die Farbe löschen, die vom FillColor-Element angegeben wird. Dieser Wert wird in D3d8types.h definiert.
D3DCLEAR_STENCIL (0x00000004l)	Der Treiber sollte den Schablonenpuffer des Kontexts auf den Wert löschen, der vom FillStencil-Element angegeben wird. Dieser Wert wird in D3d8types.h definiert.
D3DCLEAR_ZBUFFER (0x00000002l)	Der Treiber sollte den Tiefenpuffer des Kontexts auf die vom FillDepth-Element angegebene Tiefe löschen. Dieser Wert wird in D3d8types.h definiert.
D3DCLEAR_COMPUTERECTS (0x00000008l)	Wenn Rechtecke für das Löschen angegeben werden, sollte der Treiber sie für den aktuellen Viewport abschneiden. Wenn keine Rechtecke angegeben sind, sollte der Treiber den gesamten Viewport löschen. Dieser Wert wird in D3dhal.h definiert.

[in] FillColor

Der Farbwert, für den der Treiber das Renderziel des Kontexts löschen soll.

[in] FillDepth

Der Wert, den der Treiber verwenden soll, um die Tiefe im Tiefenpuffer des Kontexts festzulegen. Dieser Member kann ein Wert im Bereich von 0,0 bis 1,0 sein.

[in] FillStencil

Der Wert, für den der Treiber den Schablonenpuffer des Kontexts löschen soll. Dieser Member kann eine ganze Zahl im Bereich von 0 bis 2ⁿ-1 sein, wobei n die Anzahl der Bits im Schablonenpuffer ist.

Hinweise

Bei einem Aufruf der Clear-Funktion des Benutzermodusanzeigetreibers wird im pData-Parameter ein Zeiger auf eine D3DDDIARG_CLEAR Struktur übergeben. Die Microsoft Direct3D-Runtime übergibt Informationen an die Parameter NumRect und pRect in einem Aufruf der Clear-Funktion des Benutzermodusanzeigetreibers, um die rechteckigen Bereiche des Puffers anzugeben, die der Treiber löschen soll.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Kopfzeile	d3dumddi.h (include D3dumddi.h)

Weitere Informationen

Clear