Platform SDK: DirectX

IDirect3DDevice7::GetTexture

IDirect3DDevice7::GetTexture メソッドは、デバイスの、指定のステージに割り当てられたテクスチャを検索して取り出す。

HRESULT GetTexture( 
  DWORD dwStage,
  LPDIRECTDRAWSURFACE7 * lplpTexture
); 

パラメータ

dwStage
検索して取り出すテクスチャのステージ識別子。ステージ識別子はゼロをベースとする。現在、デバイスは最大 8 セットまでテクスチャを持つことができる。したがって、dwStage に許容される最大値は 7 である。
lplpTexture
呼び出しが成功したときに、指定されたテクスチャの IDirectDrawSurface7 インターフェイスへのポインタを格納する変数のアドレス。

戻り値

成功すれば D3D_OK を返す。

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

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS

注意

従来の IDirect3DDevice3 インターフェイスでは、このメソッドは IDirect3DTexture2 インターフェイスへのポインタを受け取る。

動作環境

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

参照

IDirect3DDevice7::SetTextureIDirect3DDevice7::GetTextureStageStateIDirect3DDevice3::SetTextureStageStateテクスチャ