IDebugClient::AttachKernel-Methode (dbgeng.h)

Artikel
02/23/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	Anfügen an den Kernel auf dem Zielcomputer.
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 Schalter -k in den WinDbg- und KD-Befehlszeilen folgen. Umgebungsvariablen wirken sich auf ConnectOptions genauso aus, wie sie sich auf den Schalter -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 Debuginformationen zu erhalten.

Rückgabewert

Diese Methode gibt möglicherweise auch Fehlerwerte zurück. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.

Hinweise

Hinweis Die Engine 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. den anfänglichen Haltepunkt, wird es in der Debuggersitzung verfügbar.

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