estructura D3DKMT_ESCAPE (d3dkmthk.h)
La estructura D3DKMT_ESCAPE describe información que se intercambia entre un controlador de pantalla en modo de usuario (UMD) (o controlador cliente) y el controlador de miniporte de pantalla en modo kernel (KMD).
Sintaxis
typedef struct _D3DKMT_ESCAPE {
[in] D3DKMT_HANDLE hAdapter;
[in] D3DKMT_HANDLE hDevice;
[in] D3DKMT_ESCAPETYPE Type;
[in] D3DDDI_ESCAPEFLAGS Flags;
[in/out] VOID *pPrivateDriverData;
[in] UINT PrivateDriverDataSize;
[in] D3DKMT_HANDLE hContext;
} D3DKMT_ESCAPE;
Miembros
[in] hAdapter
Identificador del adaptador de gráficos en el que se intercambia información.
[in] hDevice
Identificador de un dispositivo para mostrar que se especifica opcionalmente si la información que se va a intercambiar es específica de un dispositivo determinado.
[in] Type
Un D3DKMT_ESCAPETYPE valor de enumeración que indica que se va a intercambiar información con el KMD o para controlar los componentes en modo kernel. En la tabla siguiente se muestran los valores posibles.
| valor | significado |
|---|---|
| D3DKMT_ESCAPE_DRIVERPRIVATE (0) | El miembro pPrivateDriverData está dirigido al KMD. El proveedor de hardware define el formato de los datos de escape. |
| D3DKMT_ESCAPE_VIDMM (1) | No use; solo con fines de prueba. El controlador UMD/cliente controla el administrador de memoria de vídeo (VidMm). El búfer que pPrivateDriverData apunta a contiene una estructura de D3DKMT_VIDMM_ESCAPE que admite varios tipos de control de VidMm. |
| D3DKMT_ESCAPE_TDRDBGCTRL (2) | No use; solo con fines de prueba. La operación de escape permite al usuario controlar el comportamiento del proceso de detección y recuperación (TDR) del sistema operativo. Esta funcionalidad está deshabilitada de forma predeterminada. Para habilitar esta funcionalidad, el valor del Registro TdrTestMode = TdrTestMode DWORD, que se almacena en la clave HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\GraphicsDrivers, debe establecerse en 1. El miembro PrivateDriverDataSize se establece en sizeof(int). El miembro pPrivateDriverData se establece en un entero con un valor del tipo de enumeración D3DKMT_TDRDBGCTRLTYPE. |
| D3DKMT_ESCAPE_VIDSCH (3) | No use; solo con fines de prueba. El controlador UMD/client controla el programador de GPU (que forma parte de Dxgkrnl). El búfer que pPrivateDriverData apunta a contiene una estructura de D3DKMT_VIDSCH_ESCAPE que admite el control de adelantamiento y la suspensión o reanudación del programador. |
| D3DKMT_ESCAPE_DEVICE (4) | No use; solo con fines de prueba. El controlador umD/cliente controla el dispositivo para mostrar. El búfer que pPrivateDriverData apunta a contiene una estructura de D3DKMT_DEVICE_ESCAPE que admite la obtención del origen del vídeo presente a partir de la asignación principal. |
| D3DKMT_ESCAPE_DMM (5) | No use; solo con fines de prueba. El controlador umD/cliente controla el administrador del modo de presentación. El búfer que pPrivateDriverData apunta a contiene una estructura D3DKMT_DMM_ESCAPE. |
| D3DKMT_ESCAPE_DEBUG_SNAPSHOT (6) | No use; solo con fines de prueba. El controlador UMD/client recupera un búfer de instantáneas de depuración. El búfer que pPrivateDriverData apunta a que contiene una estructura de D3DKMT_DEBUG_SNAPSHOT_ESCAPE. |
| D3DKMT_ESCAPE_SETDRIVERUPDATESTATUS (7) | No use; solo con fines de prueba. El controlador UMD/client establece el estado de actualización de KMD. |
| D3DKMT_ESCAPE_DRT_TEST (8) | No use; solo con fines de prueba. |
| D3DKMT_ESCAPE_DIAGNOSTICS (9) | No use; solo con fines de prueba. Se admite a partir de Windows 8. |
| D3DKMT_ESCAPE_OUTPUTDUPL_SNAPSHOT (10) | No use; solo con fines de prueba. Se admite a partir de Windows 8. |
| D3DKMT_ESCAPE_OUTPUTDUPL_DIAGNOSTICS (11) | No use; solo con fines de prueba. Se admite a partir de Windows 8. |
| D3DKMT_ESCAPE_BDD_PNP (12) | No use; solo con fines de prueba. Se admite a partir de Windows 8. |
| D3DKMT_ESCAPE_BDD_FALLBACK (13) | No use; solo con fines de prueba. Se admite a partir de Windows 8. |
| D3DKMT_ESCAPE_ACTIVATE_SPECIFIC_DIAG(14) | No use; solo con fines de prueba. Se admite a partir de Windows 8. |
| D3DKMT_ESCAPE_MODES_PRUNED_OUT(15) | No use; solo con fines de prueba. Se admite a partir de Windows 8. |
| D3DKMT_ESCAPE_WQHL_INFO(16) | No use; solo con fines de prueba. Se admite a partir de Windows 8. |
| D3DKMT_ESCAPE_BRIGHTNESS(17) | No use; solo con fines de prueba. Se admite a partir de Windows 8. |
| D3DKMT_ESCAPE_EDID_CACHE(18) | No use; solo con fines de prueba. Se admite a partir de Windows 8. |
| D3DKMT_ESCAPE_GENERIC_ADAPTER_DIAG_INFO(19) | No use; solo con fines de prueba. Se admite a partir de Windows 8. |
| D3DKMT_ESCAPE_MIRACAST_DISPLAY_REQUEST (20) | No use; solo con fines de prueba. Se admite a partir de Windows 8.1. |
| D3DKMT_ESCAPE_HISTORY_BUFFER_STATUS (21) | No use; solo con fines de prueba. Se admite a partir de Windows 8.1. |
| D3DKMT_ESCAPE_MIRACAST_ADAPTER_DIAG_INFO (23) | No use; solo con fines de prueba. Se admite a partir de Windows 8.1. |
| D3DKMT_ESCAPE_WIN32K_START(1024) | No use; solo con fines de prueba. Se admite a partir de Windows 8. |
| D3DKMT_ESCAPE_WIN32K_HIP_DEVICE_INFO(1024) | No use; solo con fines de prueba. Se admite a partir de Windows 8. |
| D3DKMT_ESCAPE_WIN32K_QUERY_CD_ROTATION_BLOCK (1025) | No use; solo con fines de prueba. Se admite a partir de Windows 8. |
| D3DKMT_ESCAPE_WIN32K_DPI_INFO (1026) | No use; solo con fines de prueba. Se admite a partir de Windows 8.1. |
| D3DKMT_ESCAPE_WIN32K_PRESENTER_VIEW_INFO (1027) | No use; solo con fines de prueba. Se admite a partir de Windows 8.1. |
| D3DKMT_ESCAPE_WIN32K_SYSTEM_DPI (1028) | No use; solo con fines de prueba. Se admite a partir de Windows 8.1. |
[in] Flags
Estructura D3DDDI_ESCAPEFLAGS que indica, en marcas de campo de bits, cómo compartir información. El controlador UMD/client debe especificar el hardwareAccess marca de campo de bits para indicar que el KMD debe tener acceso al hardware gráfico de tal manera que el sistema operativo debe realizar el segundo nivel de sincronización en el KMD para la llamada DxgkDdiEscape.
hardwareAccess debe establecerse en cero cuando se usa la virtualización. Para obtener más información, consulte paravirtualización de GPU.
[in/out] pPrivateDriverData
Puntero a un búfer que asigna el controlador de cliente o UMD que contiene una estructura de escape de controlador conocida. Esta estructura contiene información que el controlador intercambia con el KMD o usa para controlar los componentes del modo kernel. En la tabla siguiente se describe el contenido del búfer al que apunta pPrivateDriverData, según el valor de Type.
| Valor de tipo | Contenido del búfer pPrivateDriverData |
|---|---|
| D3DKMT_ESCAPE_DRIVERPRIVATE | Específico del controlador. El búfer no se puede usar a menos que exista un acoplamiento estrecho entre el controlador UMD/cliente y el KMD. |
| D3DKMT_ESCAPE_VIDMM | No use; solo con fines de prueba. Estructura D3DKMT_VIDMM_ESCAPE. |
| D3DKMT_ESCAPE_TDRDBGCTRL | No use; solo con fines de prueba. Tipo de enumeración D3DKMT_TDRDBGCTRLTYPE. |
| D3DKMT_ESCAPE_VIDSCH | No use; solo con fines de prueba. Estructura D3DKMT_VIDSCH_ESCAPE. |
| D3DKMT_ESCAPE_DEVICE | No use; solo con fines de prueba. Estructura D3DKMT_DEVICE_ESCAPE. |
| D3DKMT_ESCAPE_DMM | No use; solo con fines de prueba. Estructura D3DKMT_DMM_ESCAPE. |
| D3DKMT_ESCAPE_DEBUG_SNAPSHOT | No use; solo con fines de prueba. Estructura D3DKMT_DEBUG_SNAPSHOT_ESCAPE. |
[in] PrivateDriverDataSize
Tamaño, en bytes, del búfer al que pPrivateDriverData apunta. El controlador UMD/client debe especificar el tamaño del búfer cuando llama a la función D3DKMTEscape.
[in] hContext
Identificador de un contexto que se especifica opcionalmente si la información que se va a intercambiar es específica de un contexto de dispositivo determinado. Si el controlador UMD/client establece hContext en un valor distinto de NULL, el controlador también debe haber establecido hDevice en un valor distinto de NULL y hDevice debe corresponder al dispositivo que posee el contexto.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista |
| encabezado de |
d3dkmthk.h (incluya D3dkmthk.h) |