Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
La función D3DKMTEscape intercambia información entre el controlador de pantalla en modo de usuario (UMD) (o controlador cliente) y el controlador de minipuerto de pantalla en modo kernel (KMD).
Sintaxis
NTSTATUS D3DKMTEscape(
[in] const D3DKMT_ESCAPE *unnamedParam1
);
Parámetros
[in] unnamedParam1
Puntero a una estructura de D3DKMT_ESCAPE que describe la información intercambiada.
Valor devuelto
D3DKMTEscape devuelve uno de los siguientes valores:
| Código devuelto | Descripción |
|---|---|
| STATUS_SUCCESS | La información se compartió correctamente. |
| STATUS_DEVICE_REMOVED | El adaptador de gráficos se detuvo o se restableció el dispositivo de pantalla. |
| STATUS_INVALID_PARAMETER | Los parámetros se validaron y determinaron que son incorrectos. |
| STATUS_NO_MEMORY | D3DKMTEscape no se pudo completar debido a una memoria insuficiente. |
| STATUS_PRIVILEGED_INSTRUCTION | D3DKMTEscape detectó instrucciones sin privilegios (es decir, instrucciones que acceden a la memoria más allá del privilegio del proceso actual de CPU). |
| STATUS_ILLEGAL_INSTRUCTION | D3DKMTEscape instrucciones detectadas que no pueden ser compatibles con el hardware gráfico. |
Esta función también puede devolver otros valores de NTSTATUS.
Observaciones
El controlador de cliente o UMD llama a D3DKMTEscape para intercambiar datos directamente con el KMD. Con fines de prueba, se puede llamar a D3DKMTEscape para controlar el administrador de memoria de vídeo (VidMm) y el programador de GPU (que forman parte de Dxgkrnl.sys) y el comportamiento del proceso de detección y recuperación (TDR) del sistema operativo.
Los proveedores de hardware pueden usar D3DKMTEscape en sus controladores como mecanismo de extensión. Sin embargo, los proveedores deben notificar las extensiones necesarias a Microsoft para que el sistema operativo pueda admitir las extensiones de forma nativa.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista |
| de la plataforma de destino de | Universal |
| encabezado de | d3dkmthk.h (incluya D3dkmthk.h) |
| biblioteca de | Gdi32.lib |
| DLL de | Gdi32.dll |