IDirect3DDevice9::CreateQuery

ステータスのクエリを作成します。

HRESULT 
CreateQuery(
  D3DQUERYTYPE Type,
  IDirect3DQuery9** ppQuery
);

パラメータ

  • Type
    クエリの種類を表します。詳細については、「D3DQUERYTYPE」を参照してください。
  • ppQuery
    クエリ オブジェクトを管理するクエリ インターフェイスへのポインターを返します。「IDirect3DQuery9」を参照してください。 このパラメーターを NULL に設定して、クエリがサポートされているかどうかを確認できます。クエリがサポートされていない場合は、このメソッドは D3DERR_NOTAVAILABLE を返します。

戻り値

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

解説 

このメソッドは、同期クエリおよび非同期クエリの両方に使用するように設計されています。Direct3D 9 でサポートされなくなった GetInfo は、このメソッドに置き換えられました。

同期クエリおよび非同期クエリは、D3DQUERYTYPE を使用して IDirect3DDevice9::CreateQuery によって作成されます。クエリが既に作成され、クエリ対象の API 呼び出しが実行されているときは、IDirect3DQuery9::Issue を使用してクエリを発行し、IDirect3DQuery9::GetData を使用してクエリの結果を取得します。

要件

ヘッダー: D3D9.h 宣言

ライブラリ: D3D9.lib 内容

関連項目

非同期通知 (Direct3D 9)