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

Статья
02/26/2024

Функция обратного вызова pfnEscapeCb предоставляет сведения драйверу мини-порта дисплея.

Синтаксис

PFND3DDDI_ESCAPECB Pfnd3dddiEscapecb;

HRESULT Pfnd3dddiEscapecb(
  HANDLE hAdapter,
  const D3DDDICB_ESCAPE *unnamedParam2
)
{...}

Параметры

hAdapter

Дескриптор объекта графического адаптера.

unnamedParam2

pData [in, out]

Указатель на структуру D3DDDICB_ESCAPE , описывающую общие сведения.

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

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

Код возврата	Описание
S_OK	Информация была успешно передана.
E_OUTOFMEMORY	pfnEscapeCb не удалось завершить из-за нехватки памяти.
E_INVALIDARG	Параметры были проверены и определены как неверные.
D3DDDIERR_DEVICEREMOVED	pfnEscapeCb не удалось инициировать вызов функции DxgkDdiEscape драйвера дисплея miniport, так как произошла остановка Plug and Play (PnP) или событие обнаружения и восстановления времени ожидания (TDR). Функция драйвера отображения пользовательского режима, которая вызвала pfnEscapeCb, должна возвращать этот код ошибки обратно в среду выполнения Direct3D. Direct3D версии 9 Примечание. Дополнительные сведения о возврате кодов ошибок см. в разделе Возврат кодов ошибок, полученных от функций среды выполнения. Direct3D версий 10 и 11 Примечание. Если функция драйвера не возвращает значение (то есть имеет VOID для типа возвращаемого параметра), функция драйвера вызывает функцию pfnSetErrorCb для отправки кода ошибки обратно в среду выполнения. Дополнительные сведения об обработке кодов ошибок см. в разделе Обработка ошибок.

Эта функция также может возвращать другие значения HRESULT.

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

Direct3D версии 11 Примечание. Дополнительные сведения о том, как драйвер вызывает pfnEscapeCb, см. в разделе Изменения direct3D 10.

Требования

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

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

D3DDDICB_ESCAPE

D3DDDI_DEVICECALLBACKS

DxgkDdiEscape