Metodo IDebugClient3::AttachKernel (dbgeng.h)

Articolo
02/25/2024

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	Collegarsi a un kernel usando un driver eXDI.

[in, optional] ConnectOptions

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

DEBUG_ATTACH_KERNEL_CONNECTION

ConnectOptions verrà interpretato allo stesso modo delle opzioni che seguono l'opzione -k nelle righe di comando WinDbg e KD. Le variabili di ambiente influiscono su ConnectOptions nello stesso modo in cui influiscono sul commutatore -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 altre informazioni, vedere Valori restituiti .

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.

Commenti

Nota Il motore non è completamente collegato al kernel finché non è stato 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 alle destinazioni in modalità kernel live, vedere Destinazioni live Kernel-Mode.