IDirect3DDevice9::GetTexture

[アーティクル]
05/11/2010

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

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

パラメータ

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

戻り値

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

解説　

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

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

要件

ヘッダー: D3D9.h 宣言

関連項目

IDirect3DDevice9::SetTexture, IDirect3DDevice9::GetTextureStageState IDirect3DDevice9::SetTextureStageState