функция обратного вызова PFND3D12DDI_BEGIN_END_QUERY (d3d12umddi.h)

Статья
02/22/2024

Функция обратного вызова pfnBeginEndQuery определяет начало части списка команд, к которой применяется запрос.

Синтаксис

PFND3D12DDI_BEGIN_END_QUERY Pfnd3d12ddiBeginEndQuery;

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

Параметры

unnamedParam1

hCommandList

Дескриптор данных драйвера для списка команд. Драйвер использует эту область памяти для хранения внутренних структур данных, связанных со списком команд.

unnamedParam2

hQueryHeap

Дескриптор кучи запросов, представляющий массив результатов запроса. Базовое представление данных результата запроса зависит от IHV в кучах запросов и непрозрачно для приложений. Результаты запроса хранятся в куче запросов до тех пор, пока они не будут "разрешены" в формате, определенном API.

unnamedParam3

StartElement

Значение элемента start.

unnamedParam4

QueryType

Тип запроса. Разрешение используется приложениями для преобразования результата запроса, ранее хранящегося в куче запросов, в формат, определенный API. Разрешенные данные хранятся в буфере D3D12. Затем результаты можно использовать с помощью шейдера, предикаций или сопоставить и прочитать на ЦП.

Возвращаемое значение

None

Remarks

Begin/End query and resolve query — это запланированные команды, которые обрабатываются в GPU. Не существует определенной точки входа, разрешающей обработку ЦП в результатах запроса.

Запросы, которые не применяются к нескольким командам, могут использоваться только для EndQuery. Например, если запрос D3D12DDI_QUERY_TYPE_VIDEO_DECODE_STATISTICS применяется только к предыдущей команде DecodeFrame в том же списке команд, для этого типа запроса используется только EndQuery.

Требования

Требование	Значение
Минимальная версия клиента	Windows 10
Верхняя часть	d3d12umddi.h (включая d3d12umddi.h)

Поделиться через