PFND3D10DDI_QUERYBEGIN コールバック関数 (d3d10umddi.h)

  • [アーティクル]

QueryBegin 関数は、クエリの一連のグラフィックス コマンドの先頭をマークし、クエリを "ビルド" 状態に切り替えます。

構文

PFND3D10DDI_QUERYBEGIN Pfnd3d10ddiQuerybegin;

void Pfnd3d10ddiQuerybegin(
  D3D10DDI_HDEVICE unnamedParam1,
  D3D10DDI_HQUERY unnamedParam2
)
{...}

パラメーター

unnamedParam1

hDevice [in]

ディスプレイ デバイス (グラフィックス コンテキスト) へのハンドル。

unnamedParam2

hQuery [in]

開始するクエリ オブジェクトへのハンドル。

戻り値

なし

解説

ドライバーは 、pfnSetErrorCb コールバック関数を使用してエラー コードを設定できます。

ドライバーは、 D3D10DDI_QUERY_EVENTまたはD3D10DDI_QUERY_TIMESTAMPクエリ操作の QueryBegin 関数をサポートするために必要ありません。 このようなクエリ操作には、暗黙的な開始が含まれます。

Microsoft Direct3D ランタイムは、SetPredication 関数の呼び出しを通じてパイプラインに現在バインドされている述語に対して QueryBegin を呼び出すことはできません。

D3DDDIERR_DEVICEREMOVEDを除き、ドライバーでエラーが発生しないようにする必要があります。 したがって、 ドライバーが pfnSetErrorCb 関数の呼び出しで、D3DDDIERR_DEVICEREMOVEDを除くエラーを渡した場合、Direct3D ランタイムはエラーが重要であると判断します。 デバイスが削除された場合でも、ドライバーはD3DDDIERR_DEVICEREMOVEDを返す必要はありません。ただし、デバイスの削除が QueryBegin の操作に干渉した場合 (通常は実行しないでください)、ドライバーはD3DDDIERR_DEVICEREMOVEDを返すことができます。

要件

要件 値
サポートされている最小のクライアント Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。
対象プラットフォーム デスクトップ
Header d3d10umddi.h (D3d10umddi.h を含む)

こちらもご覧ください

D3D10DDI_DEVICEFUNCS

QueryEnd

SetPredication

pfnSetErrorCb