Microsoft DirectX 8.0 (C++)

IDirect3DDevice8::GetInfo

レンダリング デバイスについての情報を取得する。

HRESULT GetInfo(
  DWORD DevInfoID,
  VOID* pDevInfoStruct,
  DWORD DevInfoStructSize
);

パラメータ

DevInfoID
[in] pDevInfoStruct に返される情報を識別するために使用される値。
pDevInfoStruct
[in, out] 呼び出しが成功した場合に、指定したデバイスの情報を受け取る構造体へのポインタ。
DevInfoStructSize
[in] pDevInfoStruct の構造体のサイズ (バイト単位)。

戻り値

成功した場合は、D3D_OK を返す。このメソッドは、Microsoft® DirectX® のリテール ビルドでは S_FALSE を返す (「注意」を参照)。

失敗した場合は、D3DERR_INVALIDCALL を返す。

注意

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

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

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

動作環境

  ヘッダー : d3d8.h で宣言。
  インポート ライブラリ : D3d8.lib を使用。