D3DHAL_DP2TEXTURESTAGESTATE Struktur (d3dhal.h)
Mindestens eine D3DHAL_DP2TEXTURESTAGESTATE Strukturen werden vom Befehlspuffer vom D3dDrawPrimitives2 Rückruf analysiert, wenn das bCommand Member der D3DHAL_DP2COMMAND Struktur auf D3DDP2OP_TEXTURESTAGESTATE festgelegt ist und zum Festlegen des entsprechenden Texturstufenzustands verwendet wird.
Syntax
typedef struct _D3DHAL_DP2TEXTURESTAGESTATE {
WORD wStage;
WORD TSState;
DWORD dwValue;
} D3DHAL_DP2TEXTURESTAGESTATE;
Angehörige
wStage
Identifiziert die Texturstufe, in der der Texturzustand aktualisiert werden soll. Dieses Element kann eine ganze Zahl im Bereich 0 bis 7 sein, wobei die höchste nummerierte Textur dem Framepuffer am nächsten kommt.
TSState
Gibt einen D3DTEXTURESTAGESTATETYPE Aufzählungswert an, der den zu aktualisierenden Texturzustand angibt. DirectX 9.0- und höher-Anwendungen können Werte in der D3DSAMPLERSTATETYPE Enumeration verwenden, um die Eigenschaften texturbezogener Renderzustände im Sampler zu steuern. In DirectX 8.0 und früheren Versionen wurden diese Samplerzustände in der D3DTEXTURESTAGESTATETYPE-Enumeration enthalten. Die Laufzeit ordnet benutzermodus-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, auf den der Treiber den durch TSState identifizierten Texturzustand aktualisieren soll.
Bemerkungen
D3dDrawPrimitives2- sollte wStateCount D3DHAL_DP2TEXTURESTAGESTATE Strukturen aus dem Befehlspuffer verarbeiten. Der Wert 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 bei dwStage- zugeordnet ist, um den neuen Wert basierend auf TSStatewiderzuspiegeln.
Treiber, die multitexturing nicht unterstützen, sollten nur Unterstützung für Texturstufe 0 implementieren.
Die folgende Abbildung zeigt einen Teil eines Beispielbefehlspuffers mit einem D3DDP2OP_TEXTURESTAGESTATE Befehl und drei D3DHAL_DP2TEXTURESTAGESTATE Strukturen. Der Treiber sollte die Stufen 0 und drei seiner privaten Texturstufen entsprechend aktualisieren.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | d3dhal.h (einschließlich D3dhal.h) |
Siehe auch
D3DDP2OP_TEXTURESTAGESTATE