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

查詢的類型。 應用程式會使用 Resolve,將先前儲存在查詢堆積中的查詢結果轉換成 API 定義的格式。 解析的數據會儲存在 D3D12 緩衝區中。 然後,著色器、預先定義或對應和讀取CPU即可取用結果。

unnamedParam4

StartElement

start 元素的值。

傳回值

備註

開始/結束查詢和解析查詢是在 GPU 上處理的排程命令。 沒有定義的進入點可允許查詢結果上的CPU處理。

不適用於多個命令的查詢可能會定義為只使用 EndQuery。 例如,如果D3D12DDI_QUERY_TYPE_VIDEO_DECODE_STATISTICS查詢僅適用於相同命令清單中的先前 DecodeFrame 命令,則只會使用此查詢類型使用 EndQuery。

規格需求

需求
目標平台 Windows
標頭 d3d12umddi.h (包含 D3d12umddi.h)