Platform SDK: DirectX |
IDirect3DDevice7::GetInfo メソッドは、レンダリング デバイス情報を取得する。この情報は、Direct3D 関連または基本となるデバイス ドライバに関連するものである。
HRESULT GetInfo( DWORD dwDevInfoID, LPVOID pDevInfoStruct, DWORD dwSize );
成功すれば 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 で宣言。