PFND3D12DDI_BEGIN_END_QUERY_0003 コールバック関数 (d3d12umddi.h)

  • [アーティクル]

pfnBeginQuery コールバック関数は、クエリが適用されるコマンド リストの部分の先頭を定義します。

構文

PFND3D12DDI_BEGIN_END_QUERY_0003 Pfnd3d12ddiBeginEndQuery0003;

void Pfnd3d12ddiBeginEndQuery0003(
  D3D12DDI_HCOMMANDLIST unnamedParam1,
  D3D12DDI_HQUERYHEAP unnamedParam2,
  D3D12DDI_QUERY_TYPE unnamedParam3,
  UINT unnamedParam4
)
{...}

パラメーター

unnamedParam1

hCommandList

コマンド リストのドライバーのデータへのハンドル。 ドライバーは、このメモリ領域を使用して、コマンド リストに関連する内部データ構造を格納します。

unnamedParam2

hQueryHeap

クエリの結果の配列を表すクエリ ヒープのハンドル。 クエリ結果の基になるデータ表現は、クエリ ヒープに依存し、アプリケーションに対して不透明な IHV です。 クエリ結果は、後で API 定義形式に "解決" されるまでクエリ ヒープに格納されます。

unnamedParam3

QueryType

クエリの種類。 解決は、以前にクエリ ヒープに格納されたクエリ結果を API 定義形式に変換するためにアプリケーションによって使用されます。 解決されたデータは D3D12 バッファーに格納されます。 その後、結果をシェーダー、プリディケーション、またはマップして CPU で読み取ることができます。

unnamedParam4

StartElement

start 要素の値。

戻り値

なし

解説

クエリの開始/終了と解決は、GPU で処理されるスケジュールされたコマンドです。 クエリ結果に対する CPU 処理を許可するエントリ ポイントが定義されていません。

複数のコマンドに適用されないクエリは、EndQuery のみを使用するように定義できます。 たとえば、D3D12DDI_QUERY_TYPE_VIDEO_DECODE_STATISTICS クエリが同じコマンド リスト内の前の DecodeFrame コマンドにのみ適用される場合、このクエリの種類には EndQuery のみが使用されます。

要件

要件 値
対象プラットフォーム Windows
ヘッダー d3d12umddi.h (D3d12umddi.h を含む)