функция обратного вызова 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
Задайте для этого значение нулю. (Зарезервировано для дальнейшего использования.)
Возвращаемое значение
| Возвращаемый код | Описание |
|---|---|
|
Расширение успешно инициализировано. |
Любое другое значение указывает, что библиотека DLL расширения не смогла инициализировать, и подсистема выгрузит ее.
Замечания
Модуль ищет эту функцию по имени в каждой библиотеке DLL расширения. Эта функция должна экспортироваться библиотекой DLL расширения DbgEng.
Номер версии можно задать с помощью макроса DEBUG_EXTENSION_VERSION, найденного в dbgeng.h, например:
*Version = DEBUG_EXTENSION_VERSION(Major, Minor)
Реализации этой функции должны инициализировать все глобальные переменные, необходимые библиотеке DLL расширения.
При вызове этой функции может быть или нет сеанса, поэтому расширение не должно предполагать, что он может запрашивать сведения о сеансе.
Тип функции определяется как PDEBUG_EXTENSION_INITIALIZE в dbgeng.h.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Всеобщий |
| заголовка | dbgeng.h |