IDebugClient3::AttachKernel-Methode (dbgeng.h)

Artikel
02/26/2024

Die AttachKernel-Methoden verbinden die Debugger-Engine 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:

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

[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 von Flags ab.

DEBUG_ATTACH_KERNEL_CONNECTION

ConnectOptions wird genauso interpretiert wie die Optionen, die dem - k-Schalter in den WinDbg- und KD-Befehlszeilen folgen. Umgebungsvariablen wirken sich auf ConnectOptions genauso 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 Hardwaretest 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.

Hinweise

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

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