Platform SDK: DirectX

IDirect3DDevice7::SetTexture

IDirect3DDevice7::SetTexture メソッドは、テクスチャを、デバイスの指定されたステージに割り当てる。

HRESULT SetTexture( 
  DWORD dwStage,
  LPDIRECTDRAWSURFACE7 lpTexture
); 

パラメータ

dwStage
テクスチャを設定するステージ識別子。ステージ識別子は 0 から始まる。現在、デバイスは最大 8 セットまでテクスチャを持つことができる。したがって、dwStage に指定できる最大値は 7 である。
lpTexture
設定するテクスチャの IDirectDrawSurfece7 インターフェイスのアドレス。ミップマップやキューブ環境マップなどの複合テクスチャの場合、このパラメータは最上位サーフェスをポイントしなければならない。

戻り値

成功すれば D3D_OK を返す。

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

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS

注意

このメソッドは、割り当てられているテクスチャ サーフェスの参照カウントをインクリメントする。テクスチャが不要になった場合は、該当するステージのテクスチャを NULL に設定しなければならない。これを行わないと、サーフェスが解放されずメモリ リークが発生する。

ソフトウェア デバイスは、1 つのテクスチャを一度に複数のテクスチャ ステージに割り当てることはサポートしていない。

IDirect3DDevice3 インターフェイスでは、このメソッドは IDirect3DTexture2 インターフェイスへのポインタを使用する。

動作環境

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

参照

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