D3DHAL_DP2PIXELSHADER Struktur (d3dhal.h)

  • Artikel

Nur DirectX 8.0 und höhere Versionen.

Die D3DHAL_DP2PIXELSHADER-Struktur wird verwendet, um den aktuellen Pixel-Shader festzulegen oder einen Pixel-Shader zu löschen, je nachdem, welcher Opcode (D3DDP2OP_SETPIXELSHADER oder D3DDP2OP_DELETEPIXELSHADER) von D3dDrawPrimitives2 empfangen wird.

Syntax

typedef struct _D3DHAL_DP2PIXELSHADER {
  DWORD dwHandle;
} D3DHAL_DP2PIXELSHADER;

Member

dwHandle

Gibt das Handle für den Pixel-Shader an, der von der Runtime zugewiesen wird. Bei Löschanforderungen ist das Handle garantiert subzero. Für Setanforderungen kann das Handle 0 sein. Wenn er auf Null festgelegt ist, sollte der Treiber jeden programmierbaren Pixelzustand zurücksetzen und rückgängig machen auf ein festes Funktionspixelverarbeitungsverhalten zurücksetzen (z. B. mithilfe von Renderzuständen).

Hinweise

Beim Wechsel von der Verarbeitung fester Funktionspixel zur programmierbaren Scheitelpunktverarbeitung sollten die Werte von z. B. Legacy-Renderzuständen und Texturstufenzuständen beibehalten werden. Wenn und wenn ein Wechsel von programmierbarer zu fester Funktionspixelverarbeitung erfolgt (der Treiber erhält eine D3DDP2OP_SETPIXELSHADER mit einem Shaderhandle von 0), sollte dieser beibehaltene Zustand wiederhergestellt werden.

Beim Wechseln zwischen programmierbaren Shadern sollte jedes Konstantenregister, das über einen in der Definition dieses Shaders angegebenen Wert verfügt, auf diesen Wert festgelegt werden. Die Werte aller anderen Konstantenregister sollten unverändert bleiben.

Anforderungen

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

Weitere Informationen

D3DHAL_DP2CREATEPIXELSHADER

D3DHAL_DP2SETPIXELSHADERCONST

D3dDrawPrimitives2