IDirect3DDevice9::GetTexture メソッド (d3d9.h)

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

構文

HRESULT GetTexture(
  [in]          DWORD                 Stage,
  [out, retval] IDirect3DBaseTexture9 **ppTexture
);

[in] Stage

型: DWORD

取得するテクスチャのステージ識別子。ステージ識別子は 0 から始まります。

[out, retval] ppTexture

返されたテクスチャを表す IDirect3DBaseTexture9 インターフェイスへのポインターのアドレス。

型: HRESULT

メソッドが成功した場合、戻り値はD3D_OK。メソッドが失敗した場合は、戻り値をD3DERR_INVALIDCALLできます。

通常、状態を返すメソッドは、D3DCREATE_PUREDEVICEを使用して作成されたデバイスでは機能しません。ただし、このメソッドはインターフェイスを返すので、純粋なデバイスでも機能します。

このメソッドを呼び出すと、 IDirect3DTexture9 インターフェイスの内部参照数が増えます。この IDirect3DTexture9 インターフェイスの使用が完了したときに IUnknown::Release を呼び出さなかった場合、メモリリークが発生します。