Método IDebugClient::AttachKernel (dbgeng.h)

Artículo
02/23/2024

Los métodos AttachKernel conectan el motor del depurador a un destino de kernel.

Sintaxis

HRESULT AttachKernel(
  [in]           ULONG Flags,
  [in, optional] PCSTR ConnectOptions
);

Parámetros

[in] Flags

Especifica las marcas que controlan cómo se asocia el depurador al destino del kernel. Los valores posibles son:

Valor	Descripción
DEBUG_ATTACH_KERNEL_CONNECTION	Adjunte al kernel en el equipo de destino.
DEBUG_ATTACH_EXDI_DRIVER	Adjunte a un kernel mediante un controlador eXDI.

[in, optional] ConnectOptions

Especifica la configuración de conexión para comunicarse con el equipo que ejecuta el destino del kernel. La interpretación de ConnectOptions depende del valor de Flags.

DEBUG_ATTACH_KERNEL_CONNECTION

ConnectOptions se interpretará de la misma manera que las opciones que siguen el modificador -k en las líneas de comandos winDbg y KD. Las variables de entorno afectan a ConnectOptions de la misma manera que afectan al modificador -k .

DEBUG_ATTACH_EXDI_DRIVER

Los controladores eXDI no se describen en esta documentación. Si tiene una interfaz eXDI en el sondeo de hardware o el simulador de hardware, póngase en contacto con Microsoft para obtener información de depuración.

Valor devuelto

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto	Descripción
S_OK	Método realizado correctamente.

Comentarios

Nota El motor no se asocia completamente al kernel hasta que se haya llamado al método WaitForEvent . Solo después de que el kernel haya generado un evento (por ejemplo, el punto de interrupción inicial) estará disponible en la sesión del depurador.

Para obtener más información sobre cómo conectarse a destinos en modo kernel en directo, vea Destinos de live Kernel-Mode.