D3DHAL_DP2TEXTURESTAGESTATE-Struktur (d3dhal.h)

Mindestens eine D3DHAL_DP2TEXTURESTAGESTATE Strukturen werden vom D3dDrawPrimitives2-Rückruf aus dem Befehlspuffer analysiert, wenn der bCommand-Member der D3DHAL_DP2COMMAND-Struktur auf D3DDP2OP_TEXTURESTAGESTATE festgelegt ist und zum Festlegen des entsprechenden Texturphasenzustands verwendet wird.

Syntax

typedef struct _D3DHAL_DP2TEXTURESTAGESTATE {
  WORD  wStage;
  WORD  TSState;
  DWORD dwValue;
} D3DHAL_DP2TEXTURESTAGESTATE;

Member

wStage

Gibt die Texturphase an, in der der Texturzustand aktualisiert werden soll. Dieser Member kann eine ganze Zahl im Bereich von 0 bis 7 sein, wobei die textur mit der höchsten Nummer dem Framepuffer am nächsten kommt.

TSState

Gibt einen D3DTEXTURESTAGESTATETYPE aufgezählten Wert an, der den zu aktualisierenden Texturzustand angibt. DirectX 9.0 und höher können Werte in der D3DSAMPLERSTATETYPE-Enumeration verwenden, um die Eigenschaften von Textur-bezogenen Renderzuständen im Sampler zu steuern. In DirectX 8.0 und früher waren diese Samplerzustände in der D3DTEXTURESTAGESTATETYPE-Enumeration enthalten. Die Laufzeit ordnet Samplerzustände (D3DSAMP_Xxx) dem Kernelmodus D3DTSS_Xxx-Werten zu, sodass Treiber nicht zum Verarbeiten von Benutzermodus-Samplerzuständen erforderlich sind. Weitere Informationen zu D3DTEXTURESTAGESTATETYPE und D3DSAMPLERSTATETYPE finden Sie in der DirectX SDK-Dokumentation.

dwValue

Gibt den Wert an, in den der Treiber den von TSState identifizierten Texturzustand aktualisieren soll.

Hinweise

D3dDrawPrimitives2 sollte wStateCount D3DHAL_DP2TEXTURESTAGESTATE Strukturen aus dem Befehlspuffer verarbeiten. Der Wert von wStateCount wird in der D3DHAL_DP2COMMAND-Struktur angegeben.

Für jede D3DHAL_DP2TEXTURESTAGESTATE-Struktur sollte D3dDrawPrimitives2 den internen Texturzustand des Treibers aktualisieren, der der Textur in dwStage zugeordnet ist, um den neuen Wert basierend auf TSState widerzuspiegeln.

Treiber, die multitexturing nicht unterstützen, sollten nur die Texturstufe 0 unterstützen.

Die folgende Abbildung zeigt einen Teil eines Beispielbefehlspuffers, der einen D3DDP2OP_TEXTURESTAGESTATE-Befehl und drei D3DHAL_DP2TEXTURESTAGESTATE-Strukturen enthält. Der Treiber sollte die Phasen 0 und 3 des Zustands der privaten Texturphase entsprechend aktualisieren.

Anforderungen

Anforderung	Wert
Header	d3dhal.h (include D3dhal.h)

Weitere Informationen

D3DDP2OP_TEXTURESTAGESTATE

D3DHAL_DP2COMMAND

D3dDrawPrimitives2