функция обратного вызова PDEBUG_EXTENSION_INITIALIZE (dbgeng.h)
Функция обратного вызова DebugExtensionInitialize вызывается подсистемой после загрузки библиотеки DLL расширения DbgEng.
CALLBACK* PDEBUG_EXTENSION_INITIALIZE DebugExtensionInitialize;
Синтаксис
PDEBUG_EXTENSION_INITIALIZE PdebugExtensionInitialize;
HRESULT PdebugExtensionInitialize(
[out] PULONG Version,
[out] PULONG Flags
)
{...}
Параметры
[out] Version
Получает версию расширения. Большие 16 бит содержат основной номер версии, а низкие 16 бит — дополнительный номер версии.
[out] Flags
Присвойте этому параметру значение 0. (Зарезервировано для использования в будущем.)
Возвращаемое значение
| Код возврата | Описание |
|---|---|
|
Расширение успешно инициализировано. |
Любое другое значение указывает, что библиотеке DLL расширения не удалось инициализировать, и подсистема выгрузит ее.
Комментарии
Подсистема ищет эту функцию по имени в каждой библиотеке DLL расширения. Эта функция должна быть экспортирована библиотекой DLL расширения DbgEng.
Номер версии можно задать с помощью макроса DEBUG_EXTENSION_VERSION в dbgeng.h, например:
*Version = DEBUG_EXTENSION_VERSION(Major, Minor)
Реализации этой функции должны инициализировать все глобальные переменные, необходимые библиотеке DLL расширения.
При вызове этой функции может быть активный сеанс, поэтому расширение не должно предполагать, что оно может запрашивать сведения о сеансе.
Тип функции определен как PDEBUG_EXTENSION_INITIALIZE в dbgeng.h.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Универсальное |
| Верхняя часть | dbgeng.h |