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

  • Статья

Вызывается средой выполнения Microsoft Direct3D для определения глобальных сведений, связанных с управлением счетчиками. Должен быть реализован с помощью драйверов windows Display Driver Model (WDDM) 1.3 и более поздних версий в пользовательском режиме.

Синтаксис

PFND3DDDI_CHECKCOUNTERINFO Pfnd3dddiCheckcounterinfo;

void Pfnd3dddiCheckcounterinfo(
  HANDLE hDevice,
  D3DDDIARG_COUNTER_INFO *unnamedParam2
)
{...}

Параметры

hDevice

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

unnamedParam2

pCounterInfo [out]

Указатель на структуру D3DDDIARG_COUNTER_INFO , которую драйвер заполняет глобальной информацией, связанной с манипулирование счетчиками.

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

None

Remarks

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

Эта функция должна вести себя аналогично функции CheckCounterInfo , которая поддерживает Microsoft Direct3D 10 и более поздних версий.

Если драйвер отображения пользовательского режима не поддерживает какие-либо понятия, представленные в членах структуры D3DDDIARG_COUNTER_INFO , он может заполнить элементы D3DDDIARG_COUNTER_INFO нулями.

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

Требования

Требование Значение
Минимальная версия клиента Windows 8.1
Минимальная версия сервера Windows Server 2012 R2
Целевая платформа Персональный компьютер
Верхняя часть d3dumddi.h (включая D3d10umddi.h)

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

CheckCounterInfo

D3DDDIARG_COUNTER_INFO

pfnSetErrorCb