estructura D3DKMT_ESCAPE (d3dkmthk.h)

Artículo
10/23/2024

La estructura D3DKMT_ESCAPE describe la información que se intercambia con el controlador de minipuerto de pantalla.

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

Valor de tipo D3DKMT_ESCAPETYPE que indica que se va a intercambiar información con el controlador de miniporte de pantalla 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 controlador de minipuerto de pantalla. El proveedor de hardware define el formato de los datos de escape.
D3DKMT_ESCAPE_VIDMM (1)	No use. Solo con fines de prueba. OpenGL ICD controla el administrador de memoria de vídeo (que forma parte de Dxgkrnl.sys). El búfer que pPrivateDriverData apunta a contiene una estructura de D3DKMT_VIDMM_ESCAPE que admite varios tipos de control del administrador de memoria de vídeo.
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. OpenGL ICD controla el programador de la unidad de procesamiento de gráficos (GPU), que forma parte de Dxgkrnl.sys). 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. OpenGL ICD 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 de la asignación principal.
D3DKMT_ESCAPE_DMM (5)	No use. Solo con fines de prueba. OpenGL ICD 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. OpenGL ICD recupera un búfer de instantáneas de depuración. El búfer que pPrivateDriverData apunta a contiene una estructura D3DKMT_DEBUG_SNAPSHOT_ESCAPE.
D3DKMT_ESCAPE_SETDRIVERUPDATESTATUS (7)	No use. Solo con fines de prueba. OpenGL ICD establece el estado de actualización del controlador de miniporte para mostrar.
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. OpenGL ICD debe especificar el hardwareAccess marca de campo de bits para indicar que el controlador de miniporte de pantalla debe tener acceso al hardware gráfico de tal manera que el sistema operativo debe realizar el segundo nivel de sincronización en el controlador de miniport para la DxgkDdiEscape llamada.

[in/out] pPrivateDriverData

Puntero a un búfer que el ICD de OpenGL asigna que contiene información que openGL ICD intercambia con el controlador de miniporte de pantalla 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 del miembro Type	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 openGL ICD y el controlador de minipuerto de pantalla.
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. OpenGL ICD 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 openGL ICD establece hContext en un valor distinto de NULL, el ICD también debe haber establecido hDevice en un valor distinto de NULL y hDevice debe corresponder al dispositivo que posee el contexto.

Observaciones

Con fines de prueba, openGL ICD puede pasar un puntero a una estructura de D3DKMT_ESCAPE en una llamada al función D3DKMTEscape para controlar el administrador de memoria de vídeo y el programador de GPU (que forman parte de Dxgkrnl.sys) y el comportamiento del proceso de TDR del sistema operativo.