Поделиться через


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

Функция обратного вызова 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, так как произошла остановка и воспроизведение (PnP) или событие обнаружения времени ожидания и восстановления (TDR). Функция драйвера в пользовательском режиме, которая называется pfnEscapeCb, должна вернуть этот код ошибки обратно в среду выполнения Direct3D.
Direct3D версии 9 Примечание. Дополнительные сведения о возврате кодов ошибок см. в возврате кодов ошибок, полученных от функций среды выполнения.
Direct3D Версии 10 и 11 Примечание. Если функция драйвера не возвращает значение (то есть имеет VOID для типа возвращаемого параметра), функция драйвера вызывает функцию pfnSetErrorCb для отправки кода ошибки обратно в среду выполнения. Дополнительные сведения об обработке кодов ошибок см. в обработке ошибок.

 

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

Замечания

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

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Доступно в Windows Vista и более поздних версиях операционных систем Windows.
целевая платформа Настольный
заголовка d3dumddi.h (include D3dumddi.h)

См. также

D3DDDICB_ESCAPE

D3DDDI_DEVICECALLBACKS

DxgkDdiEscape