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

  • Статья

Функция GetQueryData извлекает сведения о запросе.

Синтаксис

PFND3DDDI_GETQUERYDATA Pfnd3dddiGetquerydata;

HRESULT Pfnd3dddiGetquerydata(
  HANDLE hDevice,
  const D3DDDIARG_GETQUERYDATA *unnamedParam2
)
{...}

Параметры

hDevice

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

unnamedParam2

pData [in, out]

Указатель на структуру D3DDDIARG_GETQUERYDATA , содержащую сведения о запросе, извлекаемом из драйвера.

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

GetQueryData возвращает одно из следующих значений:

Код возврата Описание
S_OK Операция запроса завершена, и результат запроса доступен.
S_FALSE GetQueryData успешно возвращен. Однако операция запроса не завершена, поэтому результат запроса недоступен.
E_OUTOFMEMORY GetQueryData не удалось выделить необходимую память для ее завершения.

Комментарии

Среда выполнения Microsoft Direct3D может вызывать GetQueryData в любое время после вызова функции IssueQuery драйвера отображения пользовательского режима. Драйвер отображения пользовательского режима должен проверка текущее значение ограждения относительно значения, хранящегося в структуре частных запросов драйвера, чтобы определить, завершена ли проблема с запросом.

Если запрос завершен, драйвер должен вернуть S_OK; В противном случае драйвер должен вернуть S_FALSE.

Если драйвер поддерживает многопроцессорную оптимизацию среды выполнения и предоставляет DDI-версию 0x0000000B или более поздней, среда выполнения вызовет GetQueryData повторно. Драйвер возвращает значение DDI-version в элементе DriverVersion структуры D3D10DDIARG_OPENADAPTER в вызове функции OpenAdapter драйвера. Когда среда выполнения вызывает GetQueryData повторно, один поток может выполняться внутри GetQueryData , а другой поток, ссылающийся на то же устройство отображения, выполняется внутри другой функции драйвера отображения пользовательского режима.

Требования

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

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

D3DDDIARG_GETQUERYDATA

D3DDDI_DEVICEFUNCS

IssueQuery