Compartir a través de


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

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 de 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 activo, consulte Destinos de Live Kernel-Mode.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado dbgeng.h (include Dbgeng.h)

Consulte también

AttachProcess

GetKernelConnectionOptions

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5

IsKernelDebuggerEnabled