D3DHAL_DP2TEXTURESTAGESTATE構造体 (d3dhal.h)

D3DHAL_DP2COMMAND 構造体の bCommand メンバーがD3DDP2OP_TEXTURESTAGESTATEに設定され、適切なテクスチャ ステージの状態を設定するために使用される場合、1 つ以上のD3DHAL_DP2TEXTURESTAGESTATE構造体が D3dDrawPrimitives2 コールバックによってコマンド バッファーから解析されます。

構文

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

メンバーズ

wStage

テクスチャの状態を更新するテクスチャ ステージを識別します。 このメンバーは、フレーム バッファーに最も近い番号のテクスチャを持つ、0 から 7 の範囲の整数にすることができます。

TSState

更新するテクスチャの状態を指定するD3DTEXTURESTAGESTATETYPE列挙値を指定します。 DirectX 9.0 以降のアプリケーションでは、D3DSAMPLERSTATETYPE列挙体の値を使用して、サンプラー テクスチャ関連のレンダリング状態の特性を制御できます。 DirectX 8.0 以前では、これらのサンプラー状態は D3DTEXTURESTAGESTATETYPE 列挙型に含まれていました。 ランタイムは、ユーザー モード サンプラーの状態 (D3DSAMP_Xxx) をカーネル モードD3DTSS_Xxx 値にマップして、ドライバーがユーザー モードサンプラーの状態を処理する必要がないようにします。 D3DTEXTURESTAGESTATETYPEとD3DSAMPLERSTATETYPEの詳細については、DirectX SDK のドキュメントを参照してください。

dwValue

ドライバーが TSState によって識別されるテクスチャ状態 更新する必要がある値を指定します。

備考

D3dDrawPrimitives2 コマンド バッファーから wStateCount D3DHAL_DP2TEXTURESTAGESTATE 構造体 処理する必要があります。 wStateCount の値は、D3DHAL_DP2COMMAND構造体で指定されます。

D3DHAL_DP2TEXTURESTAGESTATE構造体ごとに、D3dDrawPrimitives2 は、dwStage のテクスチャに関連付けられているドライバーの内部テクスチャ状態 TSStateに基づいて新しい値を反映するように更新する必要があります。

マルチテクスチャをサポートしていないドライバーは、テクスチャ ステージ 0 のサポートのみを実装する必要があります。

次の図は、D3DDP2OP_TEXTURESTAGESTATE コマンドと 3 つのD3DHAL_DP2TEXTURESTAGESTATE構造体を含むサンプル コマンド バッファーの一部を示しています。 ドライバーは、それに応じて、プライベート テクスチャ ステージ状態のステージ 0 と 3 を更新する必要があります。

必要条件

要件	価値
ヘッダー	d3dhal.h (D3dhal.h を含む)

関連項目

D3DDP2OP_TEXTURESTAGESTATE

D3DHAL_DP2COMMAND

D3dDrawPrimitives2 の