D3DHAL_DP2CLEAR Struktur (d3dhal.h)

Artikel
02/06/2025

D3DHAL_DP2CLEAR enthält alle Informationen, die der Treiber benötigt, um das hardwaregestützte Löschen für das Renderingziel, den Tiefenpuffer oder den Schablonenpuffer durchzuführen.

Syntax

typedef struct _D3DHAL_DP2CLEAR {
  DWORD    dwFlags;
  DWORD    dwFillColor;
  D3DVALUE dvFillDepth;
  DWORD    dwFillStencil;
  RECT     Rects[1];
} D3DHAL_DP2CLEAR;

Angehörige

dwFlags

Gibt an, welche Puffer der Treiber löschen soll. Dieses Element kann ein bitweiser OR der folgenden Werte sein:

Wert	Bedeutung
D3DCLEAR_TARGET	Der Treiber sollte das Renderziel des Kontexts auf die vom dwFillColor-Element angegebene Farbe löschen.
D3DCLEAR_STENCIL	Der Treiber sollte den Schablonenpuffer des Kontexts auf den wert löschen, der vom dwFillStencil-Element angegeben wird.
D3DCLEAR_ZBUFFER	Der Treiber sollte den Tiefenpuffer des Kontexts auf die vom dwFillDepth-Element angegebene Tiefe löschen.
D3DCLEAR_COMPUTERECTS	Nur DirectX 8.0 und höhere Versionen. Wenn dieses Kennzeichen festgelegt ist, sollten die angegebenen Rechtecke mit dem aktuellen Viewport abgeschnitten werden. Darüber hinaus ist es möglich, dass, wenn D3DCLEAR_COMPUTERECTS angegeben wird, die Anzahl der zu löschenden Rechtecke null sein kann (die Anzahl der zu löschenden Rechtecke befindet sich in der wStateCount/wPrimtiveCount-Union der D3DHAL_DP2COMMAND Struktur für das Klarzeichen). In diesem Fall sollte der gesamte Viewport gelöscht werden.

dwFillColor

Gibt die Farbe an, auf die der Treiber das Renderziel des Kontexts löschen soll.

dvFillDepth

Gibt den Wert an, den der Treiber zum Festlegen der Tiefe im Tiefenpuffer des Kontexts verwenden soll. Dieses Element kann ein Wert im Intervall 0,0 bis 1,0 sein. Der Treiber sollte diesen Wert mithilfe des dwZBitMask Member der DDPIXELFORMAT- Struktur des Tiefenpuffers in eine ganze Zahl konvertieren.

dwFillStencil

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

Rects[1]

Gibt die rechteckigen Bereiche des Puffers an, die der Treiber löschen soll. Die Rechtecke werden in Bildschirmkoordinaten angegeben. Dieses Element der Struktur enthält den ersten rechteckigen Bereich, der gelitten werden soll. Das wStateCount- Mitglied der D3DHAL_DP2COMMAND enthält die Gesamtanzahl der rechteckigen Bereiche, die eingeteilt werden sollen. Die anderen (wStateCount-1) RECT-Strukturen, die erforderlich sind, folgen der D3DHAL_DP2CLEAR Struktur ohne Abstand.

Bemerkungen

Diese Struktur wird mit dem D3DDP2OP_CLEAR Befehlstoken verwendet, um die Legacy-D3dClear- und D3dClear2 Rückrufe zu ersetzen.

Beachten Sie, dass die D3DHAL_DP2CLEAR Datenstruktur weiterhin Platz für ein einzelnes RECT enthält, wenn die Anzahl der Rechtecke null ist. Daher sollte die Größe dieses einzelnen RECT bei der Weiterentwicklung zur nächsten DP2-Anweisung einbezogen werden. Der Inhalt des RECT in diesem Fall ist jedoch nicht definiert, und der Treiber sollte nicht versuchen, sie zu lesen.

Anzeigetreiber müssen Eingabefarbwerte für die ARGB- und YUV-Klassen von Farbformaten konvertieren. Für klare Vorgänge werden Eingabefarbwerte im dwFillColor Member angegeben. Weitere Informationen finden Sie unter Behandeln von Farbwerten für Pixelformate.

Anforderungen

Anforderung	Wert
Header-	d3dhal.h (einschließlich D3dhal.h)

Siehe auch

D3DDP2OP_CLEAR

D3DHAL_DP2COMMAND

DDPIXELFORMAT-

Freigeben über