Platform SDK: DirectX

IDirect3DDevice7::GetInfo

IDirect3DDevice7::GetInfo メソッドは、レンダリング デバイス情報を取得する。この情報は、Direct3D 関連または基本となるデバイス ドライバに関連するものである。

HRESULT GetInfo( 
  DWORD  dwDevInfoID, 
  LPVOID pDevInfoStruct, 
  DWORD  dwSize
); 

パラメータ

dwDevInfoID
pDevInfoStruct のデバイス情報の構造体のタイプを示すフラグ。このパラメータは、以下のフラグのいずれかに設定できる。
D3DDEVINFOID_TEXTUREMANAGER
pDevInfoStruct の構造体は、ドライバで行われるテクスチャ管理についての情報を格納する D3DDEVINFO_TEXTUREMANAGER 構造体である。ドライバでテクスチャ管理が行われていない場合は、Direct3D によるテクスチャ管理についての情報が取得される。
D3DDEVINFOID_D3DTEXTUREMANAGER
pDevInfoStruct の構造体は、Direct3D によるテクスチャ管理についての情報を格納する D3DDEVINFO_TEXTUREMANAGER 構造体である。
D3DDEVINFOID_TEXTURING
pDevInfoStruct の構造体は、アプリケーションのテクスチャ処理アクティビティについての情報を格納する D3DDEVINFO_TEXTURING 構造体である。
pDevInfoStruct
呼び出しが成功した場合に、指定されたデバイス情報を受け取る構造体のアドレス。構造体のタイプおよび格納されたデータの解釈方法は、dwDevInfoID のフラグによって決まる。
dwSize
pDevInfoStruct の構造体のバイト単位でのサイズ。

戻り値

成功すれば D3D_OK を返す。このメソッドは、DirectX のリテール ビルドで S_FALSE を返す。

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

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS

注意

このメソッドを使用すると、ドライバでは特定の種類の情報およびそれに対応する構造体を宣言できる。これらについては、この SDK では説明されていない。

このメソッドは同期して実行されるが、この実行速度が遅い場合はアプリケーションのパフォーマンスが低下することがある。シーンのレンダリング中 (IDirect3DDevice7::BeginScene を呼び出してから IDirect3DDevice7::EndScene を呼び出すまで) は、このメソッドを呼び出してはならない。

このメソッドは、製品開発時のパフォーマンス追跡およびデバッグに使用する (DirectX のデバッグ バージョン)。このメソッドが成功して S_FALSE を返しても、デバイス データを取得していないときがある。ホスト システムに DirectX ランタイムのリテール バージョンがインストールされている場合には、このようなことが起こる。

動作環境

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

参照

D3DDEVINFO_TEXTUREMANAGER