IDebugClient4::AttachKernel-Methode (dbgeng.h)

Artikel
02/06/2025

Die AttachKernel- Methoden verbinden das Debuggermodul mit einem Kernelziel.

Syntax

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

Parameter

[in] Flags

Gibt die Flags an, die steuern, wie der Debugger an das Kernelziel anfügt. Mögliche Werte sind:

Wert	Beschreibung
DEBUG_ATTACH_KERNEL_CONNECTION	An den Kernel auf dem Zielcomputer anfügen.
DEBUG_ATTACH_EXDI_DRIVER	Fügen Sie einen Kernel mithilfe eines eXDI-Treibers an.

[in, optional] ConnectOptions

Gibt die Verbindungseinstellungen für die Kommunikation mit dem Computer an, auf dem das Kernelziel ausgeführt wird. Die Interpretation von ConnectOptions hängt vom Wert Flagsab.

DEBUG_ATTACH_KERNEL_CONNECTION

ConnectOptions- werden auf die gleiche Weise interpretiert wie die Optionen, die den Befehlszeilen "WinDbg" und "KD" folgen, auf die Befehlszeilen "WinDbg" und "KD" folgen. Umgebungsvariablen wirken sich auf ConnectOptions auf die gleiche Weise aus, wie sie sich auf den Switch -k auswirken.

DEBUG_ATTACH_EXDI_DRIVER

eXDI-Treiber werden in dieser Dokumentation nicht beschrieben. Wenn Sie über eine eXDI-Schnittstelle zu Ihrem Hardwaresonden- oder Hardwaresimulator verfügen, wenden Sie sich an Microsoft, um Informationen zum Debuggen zu erhalten.

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.

Bemerkungen

Hinweis Das Modul wird erst vollständig an den Kernel angefügt, wenn die WaitForEvent- Methode aufgerufen wurde. Erst nachdem der Kernel ein Ereignis generiert hat – z. B. der anfängliche Haltepunkt – ist es in der Debuggersitzung verfügbar.

Weitere Informationen zum Herstellen einer Verbindung mit Zielzielen im Live-Kernelmodus finden Sie unter Live Kernel-Mode Targets.