DXGKDDI_ESCAPE función de devolución de llamada (d3dkmddi.h)

La función DxgkDdiEscape comparte información con el controlador de pantalla en modo de usuario.

Sintaxis

DXGKDDI_ESCAPE DxgkddiEscape;

NTSTATUS DxgkddiEscape(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_ESCAPE pEscape
)
{...}

Parámetros

[in] hAdapter

Identificador de un bloque de contexto asociado a un adaptador de pantalla. El controlador de minipuerto de pantalla proporcionó anteriormente este identificador al subsistema del kernel de gráficos de Microsoft DirectX en la función MiniportDeviceContext parámetro de salida del DxgkDdiAddDevice.

[in] pEscape

Puntero a una estructura DXGKARG_ESCAPE que contiene información sobre la información compartida.

Nota Para que la DxgkDdiEscape llamada se realice en el segundo nivel, la marca hardwareAccess debe establecerse dentro de la estructura D3DDDI_ESCAPEFLAGS que es miembro de DXGKARG_ESCAPE. Si no se establece esta marca, se producirá un error en la llamada.

 

Valor devuelto

DxgkDdiEscape devuelve uno de los siguientes valores:

Código devuelto	Descripción
STATUS_SUCCESS	DxgkDdiEscape compartió correctamente la información.
STATUS_INVALID_PARAMETER	Los parámetros que se pasaron a DxgkDdiEscape contenían errores que impedían que se completara.
STATUS_NO_MEMORY	DxgkDdiEscape no pudo asignar memoria necesaria para que se complete.
STATUS_PRIVILEGED_INSTRUCTION	DxgkDdiEscape detectó instrucciones noprivilegadas (es decir, instrucciones que acceden a la memoria más allá del privilegio del proceso actual de la unidad de procesamiento central [CPU] actual).
STATUS_ILLEGAL_INSTRUCTION	DxgkDdiEscape detectó instrucciones que el hardware gráfico no podía admitir.
STATUS_GRAPHICS_DRIVER_MISMATCH	El controlador de miniporte de pantalla de pantalla no es compatible con el controlador de pantalla en modo de usuario que inició la llamada a DxgkDdiEscape.

Observaciones

El subsistema del kernel de gráficos de DirectX llama al controlador de miniport de pantalla dxgkDdiEscape función siempre que el controlador de pantalla en modo de usuario debe compartir información con el controlador de miniporte de pantalla de una manera que no se admite a través de otras comunicaciones del controlador.

dxgkDdiEscape debe ser paginable.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista
de la plataforma de destino de	Escritorio
encabezado de	d3dkmddi.h
irQL	PASSIVE_LEVEL

Consulte también

DXGKARG_ESCAPE

dxgkDdiAddDevice

pfnEscapeCb