функция обратного вызова 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-версии в элементе DriverVersion элемента структуры D3D10DDIARG_OPENADAPTER в вызове функции OpenAdapt er драйвера. Когда среда выполнения вызывает GetQueryData повторно, один поток может выполняться внутри GetQueryData в то время как другой поток, ссылающийся на то же устройство отображения, выполняется внутри другой функции драйвера отображения пользовательского режима.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Windows Vista и более поздних версиях операционных систем Windows. |
| целевая платформа | Настольный |
| заголовка | d3dumddi.h (include D3dumddi.h) |