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

Artículo
02/23/2024

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 el parámetro de salida MiniportDeviceContext de la función DxgkDdiAddDevice .

[in] pEscape

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

Nota Para que la llamada a DxgkDdiEscape se realice bajo el segundo nivel, la marca HardwareAccess debe establecerse dentro de la estructura D3DDDI_ESCAPEFLAGS que sea 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 completara.
STATUS_PRIVILEGED_INSTRUCTION	DxgkDdiEscape detectó instrucciones sin privilegios (es decir, instrucciones que acceden a la memoria más allá del privilegio del proceso 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.

Comentarios

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

DxgkDdiEscape debe ser paginable.