Метод IDebugClient::AttachKernel (dbgeng.h)

Статья
02/06/2025

Методы AttachKernel подключают подсистему отладчика к целевому объекту ядра.

Синтаксис

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

Параметры

[in] Flags

Указывает флаги, управляющие присоединением отладчика к целевому объекту ядра. Возможные значения:

Ценность	Описание
DEBUG_ATTACH_KERNEL_CONNECTION	Подключитесь к ядру на целевом компьютере.
DEBUG_ATTACH_EXDI_DRIVER	Подключитесь к ядру с помощью драйвера eXDI.

[in, optional] ConnectOptions

Задает параметры подключения для взаимодействия с компьютером, на котором выполняется целевой объект ядра. Интерпретация ConnectOptions зависит от значения флагов .

DEBUG_ATTACH_KERNEL_CONNECTION

ConnectOptions интерпретируются так же, как параметры, следующие за параметром -k в командной строке WinDbg и KD. Переменные среды влияют на ConnectOptions так же, как они влияют на параметр -k.

DEBUG_ATTACH_EXDI_DRIVER

Драйверы eXDI не описаны в этой документации. Если у вас есть интерфейс eXDI для аппаратного зонда или симулятора оборудования, обратитесь к корпорации Майкрософт за сведениями об отладке.

Возвращаемое значение

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в возвращаемых значений.

Возвращаемый код	Описание
S_OK	Метод был успешным.

Замечания

Примечание Подсистема не полностью присоединяется к ядру до вызова метода WaitForEvent. Только после создания события ядра (например, начальная точка останова) становится доступной в сеансе отладчика.

Дополнительные сведения о подключении к целевым объектам в режиме динамического ядра см. в разделе Live Kernel-Mode Targets.