функция обратного вызова 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 драйвера дисплея 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) |