D3DDDIARG_CLEAR Struktur (d3dumddi.h)

Artikel
02/06/2025

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;

Angehörige

[in] Flags

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

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 in die Tiefe löschen, die vom FillDepth-Element angegeben wird. Dieser Wert wird in D3d8types.h definiert.
D3DCLEAR_COMPUTERECTS (0x00000008l)	Wenn Rechtecke zum Löschen angegeben sind, sollte der Treiber sie mit dem aktuellen Viewport abschneiden. Wenn keine Rechtecke angegeben werden, sollte der Treiber den gesamten Viewport löschen. Dieser Wert wird in D3dhal.h definiert.

[in] FillColor

Der Farbwert, auf den der Treiber das Renderziel des Kontexts löschen soll.

[in] FillDepth

Der Wert, den der Treiber zum Festlegen der Tiefe im Tiefenpuffer des Kontexts verwenden soll. Dieses Element kann ein Wert im Bereich von 0,0 bis 1,0 sein.

[in] FillStencil

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

Bemerkungen

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

Anforderungen

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

Siehe auch

löschen

Freigeben über