Metodo IDebugClient5::AttachKernel (dbgeng.h)

Articolo
02/23/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 la modalità di collegamento del debugger 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 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 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 è stato eseguito correttamente.

Commenti

Nota Il motore non è completamente collegato 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 attive, vedere Live Kernel-Mode Targets.