IDirect3DQuery9

IDirect3DQuery9 (d3d9.h) インターフェイスです。アプリケーションは IDirect3DQuery9 インターフェイスのメソッドを使用して、ドライバーに対する非同期クエリを実行します。

LPDIRECT3DQUERY9 型および PDIRECT3DQUERY9 型は、IDirect3DQuery9 インターフェイスへのポインターとして定義されています。

typedef struct IDirect3DQuery9 *LPDIRECT3DQUERY9, *PDIRECT3DQUERY9;

IDirect3DQuery9::GetDevice (d3d9.h) メソッドは、クエリ対象のデバイスを取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になることがあります。

IDirect3DQuery9::GetType (d3d9.h) メソッドは、クエリの種類を取得します。

型: D3DQUERYTYPE

クエリの種類を返します。D3DQUERYTYPE を参照してください。

IDirect3DQuery9::GetDataSize (d3d9.h) メソッドは、クエリデータのバイト数を取得します。

型: DWORD

クエリデータのバイト数を返します。

IDirect3DQuery9::Issue (d3d9.h) メソッドは、クエリを発行します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になることがあります。

クエリがシグナル状態になったということは、クエリが完了してデータが利用可能になり、IDirect3DQuery9::GetData が S_OK を返すことを意味します。

IDirect3DQuery9::GetData メソッド (d3d9.h) は、クエリ対象のリソースをポーリングして、クエリの状態またはクエリ結果を取得します。

型: HRESULT

戻り値の型はクエリの状態を示します (Queries (Direct3D 9) を参照)。クエリデータが利用可能な場合は S_OK を、利用できない場合は S_FALSE を返します。これらはいずれも成功を示す戻り値です。D3DGETDATA_FLUSH を使用してメソッドが失敗した場合、戻り値は D3DERR_DEVICELOST になることがあります。

クエリ状態のポーリング中にデバイスが失われる可能性があります。D3DGETDATA_FLUSH を指定した場合、デバイスが失われるとこのメソッドは D3DERR_DEVICELOST を返します。これにより、失われたデバイス (クエリに応答できないデバイス) が原因でスレッドが延々とポーリングし続けることを、アプリケーションが防止できます。

アプリケーションは、GetData ( ... , 0 ) のみを呼び出し、時間が経てば GetData がひとりでに S_OK を返すと期待するようなコードを決して記述してはいけません。これは、過去に GetData で FLUSH フラグを使用していた場合でも同様です。例:

// 無限ループになり得る:
while( pQuery->GetData( ... , 0 ) == S_FALSE ) ;

// これでもまだ無限ループになり得る:
pQuery->GetData( ... , D3DGETDATA_FLUSH );
while( pQuery->GetData( ... , 0 ) == S_FALSE ) ;

// 無限ループにはならない。最終的にコマンドバッファーが
// いっぱいになり、それによってフラッシュが発生するため。
while( pQuery->GetData( ..., 0 ) == S_FALSE ) {
    pDevice->SetTexture(...);
    pDevice->Draw(...);
}