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

Artigo
02/06/2025

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 forma 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 de retorno

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

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

Observações

Observação O mecanismo não é completamente anexado ao kernel até que o método WaitForEvent tenha sido chamado. Somente depois que o kernel gerar 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

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h (inclua Dbgeng.h)

Consulte também

do AttachProcess

GetKernelConnectionOptions

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5

IsKernelDebuggerEnabled

Partilhar via