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

Статья
02/29/2024

Методы 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 зависит от значения Flags.

DEBUG_ATTACH_KERNEL_CONNECTION

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

DEBUG_ATTACH_EXDI_DRIVER

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

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

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

Код возврата	Описание
S_OK	Метод выполнен успешно.

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

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