PFND3DDDI_ESCAPECB función de devolución de llamada (d3dumddi.h)
La función de devolución de llamada pfnEscapeCb comparte información con el controlador de minipuerto de pantalla.
Sintaxis
PFND3DDDI_ESCAPECB Pfnd3dddiEscapecb;
HRESULT Pfnd3dddiEscapecb(
HANDLE hAdapter,
const D3DDDICB_ESCAPE *unnamedParam2
)
{...}
Parámetros
hAdapter
Identificador del objeto de adaptador de gráficos.
unnamedParam2
pData [in, out]
Puntero a una estructura de D3DDDICB_ESCAPE que describe la información compartida.
Valor devuelto
pfnEscapeCb devuelve uno de los siguientes valores:
| código de retorno | descripción |
|---|---|
| S_OK | La información se compartió correctamente. |
| E_OUTOFMEMORY | pfnEscapeCb no se pudo completar debido a una memoria insuficiente. |
| E_INVALIDARG | Los parámetros se validaron y determinaron que son incorrectos. |
| D3DDDIERR_DEVICEREMOVED | pfnEscapeCb no pudo iniciar una llamada al función dxgkDdiEscape del controlador de miniporte de pantalla porque se ha producido una parada de Plug and Play (PnP) o un evento de detección y recuperación de tiempo de espera (TDR). La función de controlador de visualización en modo de usuario que llamó a pfnEscapeCb debe devolver este código de error al tiempo de ejecución de Direct3D. Direct3D versión 9 Nota: Para obtener más información sobre cómo devolver códigos de error, vea Devolver códigos de error recibidos de funciones en tiempo de ejecución. Direct3D Versiones 10 y 11 Nota: Si la función del controlador no devuelve un valor (es decir, tiene VOID para un tipo de parámetro devuelto), la función de controlador llama a la función pfnSetErrorCb para enviar un código de error al tiempo de ejecución. Para obtener más información sobre el control de códigos de error, consulte Control de errores. |
Esta función también puede devolver otros valores HRESULT.
Observaciones
Un controlador de pantalla en modo de usuario llama a pfnEscapeCb para compartir información varias con el controlador de miniporte de pantalla de una manera que no sea compatible con ninguna otra comunicación del controlador. El controlador de pantalla en modo de usuario puede enviar información varias al controlador de miniporte de pantalla o puede recuperar información del controlador de miniporte de pantalla.
Direct3D versión 11 Nota: Para obtener más información sobre cómo llama el controlador pfnEscapeCb, vea cambios de Direct3D 10.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
| de la plataforma de destino de | Escritorio |
| encabezado de | d3dumddi.h (incluya D3dumddi.h) |