Platform SDK: DirectX

IDirect3DDevice7::SetTextureStageState

IDirect3DDevice7::SetTextureStageState メソッドは、現在割り当てられているテクスチャのステート値を設定する。

HRESULT SetTextureStageState( 
  DWORD dwStage,
  D3DTEXTURESTAGESTATETYPE dwState,
  DWORD dwValue
); 

パラメータ

dwStage
ステート値を設定するテクスチャのステージ識別子。ステージ識別子は 0 から始まる。現在、デバイスは最大 8 セットまでテクスチャを持つことができる。したがって、dwStage に指定できる最大値は 7 である。
dwState
設定するテクスチャ ステート。このパラメータは、D3DTEXTURESTAGESTATETYPE 列挙型の任意のメンバにすることができる。
dwValue
設定するステート値。この値の意味は dwState パラメータで決まる。

戻り値

成功すれば D3D_OK を返す。

失敗すれば、次のいずれかの値を返す。

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS

注意

テクスチャ ステートの設定にはこのメソッドを使用し、従来のテクスチャ関連レンダリング ステートは使用しない。詳細については、「レンダリング ステートについて」を参照すること。

動作環境

  Windows NT/2000 :Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  バージョン :DirectX 7.0 が必要。
  ヘッダー : d3d.h で宣言。

参照

IDirect3DDevice7::GetTextureStageStateIDirect3DDevice7::GetTextureIDirect3DDevice7::SetTextureテクスチャ