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

Статья
02/06/2025

Функция обратного вызова 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

Значение начального элемента.

unnamedParam4

QueryType

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

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

Никакой

Замечания

Запрос begin/end и resolve — это запланированные команды, обрабатываемые на GPU. Для обработки ЦП в результатах запроса не определена точка входа.

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10
заголовка	d3d12umddi.h (include d3d12umddi.h)

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