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

Os métodos AttachKernel conectam o mecanismo de depurador a um destino de kernel.

Sintaxe

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

Parâmetros

[in] Flags

Especifica os sinalizadores que controlam como o depurador é anexado ao destino do kernel. Os valores possíveis são:

Valor Descrição
DEBUG_ATTACH_KERNEL_CONNECTION Anexe ao kernel no computador de destino.
DEBUG_ATTACH_EXDI_DRIVER Anexe a um kernel usando um driver eXDI.

[in, optional] ConnectOptions

Especifica as configurações de conexão para se comunicar com o computador que executa o destino do kernel. A interpretação de ConnectOptions depende do valor de Sinalizadores.

DEBUG_ATTACH_KERNEL_CONNECTION

ConnectOptions será interpretado da mesma maneira que as opções que seguem a opção -k nas linhas de comando WinDbg e KD. As variáveis de ambiente afetam ConnectOptions da mesma forma que afetam a opção -k .

DEBUG_ATTACH_EXDI_DRIVER

Os drivers eXDI não são descritos nesta documentação. Se você tiver uma interface eXDI para sua investigação de hardware ou simulador de hardware, entre em contato com a Microsoft para obter informações de depuração.

Valor retornado

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Código de retorno Descrição
S_OK
O método foi bem-sucedido.

Comentários

Nota O mecanismo não é completamente anexado ao kernel até que o método WaitForEvent tenha sido chamado. Somente depois que o kernel tiver gerado um evento, por exemplo, o ponto de interrupção inicial, ele ficará disponível na sessão do depurador.
 
Para obter mais informações sobre como se conectar a destinos do modo kernel dinâmico, consulte Destinos do Live Kernel-Mode.

Requisitos

   
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (include Dbgeng.h)

Confira também

AttachProcess

GetKernelConnectionOptions

Idebugclient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5

IsKernelDebuggerEnabled