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 del adaptador de gráficos.

unnamedParam2

pData [in, out]

Puntero a una estructura D3DDDICB_ESCAPE que describe la información compartida.

Valor devuelto

pfnEscapeCb devuelve uno de los siguientes valores:

Código devuelto	Descripción
S_OK	La información se compartió correctamente.
E_OUTOFMEMORY	pfnEscapeCb no se pudo completar debido a memoria insuficiente.
E_INVALIDARG	Los parámetros se validaron y determinaron que son incorrectos.
D3DDDIERR_DEVICEREMOVED	pfnEscapeCb no pudo iniciar una llamada a la función DxgkDdiEscape del controlador de minipuerto de pantalla porque se produjo 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. Versiones 10 y 11 de Direct3D Nota: Si la función del controlador no devuelve un valor (es decir, tiene VOID para un tipo de parámetro de valor devuelto), la función de controlador llama a la función pfnSetErrorCb para enviar un código de error de vuelta 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 podría devolver otros valores HRESULT.

Comentarios

Un controlador de pantalla en modo de usuario llama a pfnEscapeCb para compartir información variada con el controlador de miniporte de pantalla de una manera que no es compatible con ninguna otra comunicación del controlador. El controlador de pantalla en modo de usuario puede enviar información variada al controlador de minipuerto de pantalla o puede recuperar información del controlador de minipuerto de pantalla.

Nota de Direct3D versión 11: Para obtener más información sobre cómo el controlador llama a pfnEscapeCb, consulta Cambios de Direct3D 10.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino	Escritorio
Encabezado	d3dumddi.h (incluya D3dumddi.h)

Consulte también

D3DDDICB_ESCAPE

D3DDDI_DEVICECALLBACKS

DxgkDdiEscape