D3DHAL_DP2TEXTURESTAGESTATE結構 (d3dhal.h)

D3DHAL_DP2COMMAND結構的 bCommand 成員設定為 D3DDP2OP_TEXTURESTAGESTATE,並使用 來設定適當的紋理階段狀態時,D3dDrawPrimitives2 回呼會從命令緩衝區剖析一或多個D3DHAL_DP2TEXTURESTAGESTATE結構。

語法

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命令和三個D3DHAL_DP2TEXTURESTAGESTATE結構。 驅動程式應該據以更新階段零和三個其私人紋理階段狀態。

此圖顯示具有D3DDP2OP_TEXTURESTAGESTATE命令和三個D3DHAL_DP2TEXTURESTAGESTATE結構的命令緩衝區

規格需求

需求
標頭 d3dhal.h (包含 D3dhal.h)

另請參閱

D3DDP2OP_TEXTURESTAGESTATE

D3DHAL_DP2COMMAND

D3dDrawPrimitives2