IDirect3DDevice9::GetTexture

デバイスのステージに割り当てられているテクスチャーを取得します。

HRESULT 
GetTexture(
  DWORD Stage,
  IDirect3DBaseTexture9 ** ppTexture
);

パラメータ

  • Stage
    取得対象テクスチャーのステージ識別子です。ステージ識別子は 0 から始まります。
  • ppTexture
    取得するテクスチャーを表す IDirect3DBaseTexture9 インターフェイスへのポインターのアドレス。

戻り値

メソッドが成功した場合は、D3D_OK を返します。失敗した場合は、D3DERR_INVALIDCALL を返します。

解説 

通常、ステートを返すメソッドは、D3DCREATE_PUREDEVICE を使って作成されたデバイスで動作しません。ただし、このメソッドはインターフェイスを返すため、ピュア デバイスでも機能します。

このメソッドを呼び出した後は、IDirect3DTexture9 インターフェイスの内部リファレンス カウントが増加します。この IDirect3DTexture9 インターフェイスの使用を終了したときに IUnknown::Release を呼び出さないと、メモリー リークが発生します。

要件

ヘッダー: D3D9.h 宣言

ライブラリ: D3D9.lib 内容

関連項目

IDirect3DDevice9::SetTexture, IDirect3DDevice9::GetTextureStageStateIDirect3DDevice9::SetTextureStageState