Metodo IDebugClient2::AttachKernel (dbgeng.h)

Articolo
06/02/2025

I metodi AttachKernel connettono il motore del debugger a una destinazione del kernel.

Sintassi

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

Parametri

[in] Flags

Specifica i flag che controllano il modo in cui il debugger si collega alla destinazione del kernel. I valori possibili sono:

Valore	Descrizione
DEBUG_ATTACH_KERNEL_CONNECTION	Collegarsi al kernel nel computer di destinazione.
DEBUG_ATTACH_EXDI_DRIVER	Connettersi a un kernel usando un driver eXDI.

[in, optional] ConnectOptions

Specifica le impostazioni di connessione per la comunicazione con il computer che esegue la destinazione del kernel. L'interpretazione di ConnectOptions dipende dal valore di Flag.

DEBUG_ATTACH_KERNEL_CONNECTION

ConnectOptions verranno interpretati allo stesso modo delle opzioni che seguono l'opzione -k nelle righe di comando winDbg e KD. Le variabili di ambiente influiscono ConnectOptions nello stesso modo in cui influiscono sull'opzione -k.

DEBUG_ATTACH_EXDI_DRIVER

I driver eXDI non sono descritti in questa documentazione. Se si dispone di un'interfaccia eXDI per il probe hardware o il simulatore hardware, contattare Microsoft per informazioni di debug.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altri dettagli, vedere valori restituiti.

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.

Osservazioni

Nota Il motore non si connette completamente al kernel finché non viene chiamato il metodo WaitForEvent. Solo dopo che il kernel ha generato un evento, ad esempio il punto di interruzione iniziale, diventa disponibile nella sessione del debugger.

Per altre informazioni sulla connessione a destinazioni in modalità kernel in tempo reale, vedere Live Kernel-Mode Targets.