функция обратного вызова PWINDBG_EXTENSION_DLL_INIT (wdbgexts.h)

Статья
08/08/2023

Функция обратного вызова PWINDBG_EXTENSION_DLL_INIT ( WinDbgExtensionDllInit) используется для загрузки и инициализации модуля расширения.

Синтаксис

PWINDBG_EXTENSION_DLL_INIT PwindbgExtensionDllInit;

void PwindbgExtensionDllInit(
  PWINDBG_EXTENSION_APIS lpExtensionApis,
  USHORT MajorVersion,
  USHORT MinorVersion
)
{...}

Параметры

lpExtensionApis

Указатель на структуру WINDBG_EXTENSION_APIS64, которая содержит указатели на функции, которые можно использовать для стандартных операций. Скопируйте всю структуру в глобальную переменную в библиотеке DLL. Например, можно создать глобальную переменную с именем ExtensionApis, как показано в следующем примере.

WINDBG_EXTENSION_APIS64   ExtensionApis;

MajorVersion

Указывает тип сборки Microsoft Windows. Значение 0xC указывает установленную сборку Windows. Значение 0xF указывает бесплатную сборку Windows. Сохраните это значение в глобальной переменной в библиотеке DLL. Например, можно создать глобальную переменную с именем SavedMajorVersion.

MinorVersion

Указывает номер сборки Windows (например, 2600) целевой системы. Сохраните это значение в глобальной переменной в библиотеке DLL. Например, можно создать глобальную переменную с именем SavedMinorVersion.

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

None

Remarks

WinDbgExtensionDllInit вызывается отладчиком при загрузке библиотеки DLL расширения.

Рекомендуется всегда использовать в коде 64-разрядные указатели, так как при необходимости отладчик автоматически изменяет размер этих указателей. Дополнительные сведения см. в разделе 32-разрядные и 64-разрядные указатели . Однако если вы решили использовать 32-разрядные указатели, первый параметр WinDbgExtensionDllInit будет иметь тип PWINDBG_EXTENSION_APIS вместо PWINDBG_EXTENSION_APIS64.

Дополнительные сведения см. в разделе Использование обратных вызовов расширения WdbgExts.

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	wdbgexts.h

Поделиться через