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

Artigo
02/23/2024

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 Flags.

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.

Retornar valor

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 no modo kernel dinâmico, consulte Destinos de Kernel-Mode ao vivo.