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

Статья
08/07/2023

Функция QueryBegin отмечает начало последовательности графических команд для запроса и переводит запрос в состояние "сборки".

Синтаксис

PFND3D10DDI_QUERYBEGIN Pfnd3d10ddiQuerybegin;

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

Параметры

unnamedParam1

hDevice [in]

Дескриптор устройства отображения (графический контекст).

unnamedParam2

hQuery [in]

Дескриптор начинаемого объекта запроса.

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

None

Remarks

Драйвер может использовать функцию обратного вызова pfnSetErrorCb , чтобы задать код ошибки.

Драйвер не требуется для поддержки функции QueryBegin для операции запроса D3D10DDI_QUERY_EVENT или D3D10DDI_QUERY_TIMESTAMP. Такая операция запроса имеет подразумеваемое начало.

Среда выполнения Microsoft Direct3D не может вызвать QueryBegin для предиката, который в настоящее время привязан к конвейеру с помощью вызова функции SetPredication .

Драйвер не должен столкнуться с какой-либо ошибкой, за исключением D3DDDIERR_DEVICEREMOVED. Таким образом, если драйвер передает любую ошибку, за исключением D3DDDIERR_DEVICEREMOVED, в вызове функции pfnSetErrorCb , среда выполнения Direct3D определит, что ошибка является критической. Даже если устройство было удалено, драйвер не должен возвращать D3DDDIERR_DEVICEREMOVED; однако если удаление устройства помешает работе QueryBegin (что обычно не должно происходить), драйвер может вернуть D3DDDIERR_DEVICEREMOVED.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Целевая платформа	Персональный компьютер
Верхняя часть	d3d10umddi.h (включая D3d10umddi.h)

См. также раздел