Microsoft DirectX 8.0 (C++)

IDirect3DDevice8::SetTexture

テクスチャをデバイスのステージに割り当てる。

HRESULT SetTexture(
  DWORD Stage,
  IDirect3DBaseTexture8* pTexture
);

パラメータ

Stage
[in] テクスチャを設定するステージ識別子。ステージ識別子は 0 から始まる。デバイスは最大 8 セットまでテクスチャを持つことができるので、Stage に指定できる最大値は 7 である。
pTexture
[in] 設定するテクスチャを表す IDirect3DBaseTexture8 インターフェイスへのポインタ。ミップマップ テクスチャやキューブ テクスチャなどのように複雑なテクスチャの場合、このパラメータはトップレベルのサーフェスをポイントしていなければならない。

戻り値

成功した場合は、D3D_OK を返す。

失敗した場合は、D3DERR_INVALIDCALL を返す。

注意

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

動作環境

  ヘッダー : d3d8.h で宣言。
  インポート ライブラリ : D3d8.lib を使用。

参照

IDirect3DDevice8::GetTextureIDirect3DDevice8::GetTextureStageStateIDirect3DDevice8::SetTextureStageState