PDEBUG_EXTENSION_INITIALIZE回调函数 (dbgeng.h)

DebugExtensionInitialize 回调函数在加载 DbgEng 扩展 DLL 后由引擎调用。

 CALLBACK* PDEBUG_EXTENSION_INITIALIZE DebugExtensionInitialize;

语法

PDEBUG_EXTENSION_INITIALIZE PdebugExtensionInitialize;

HRESULT PdebugExtensionInitialize(
  [out] PULONG Version,
  [out] PULONG Flags
)
{...}

[out] Version

接收扩展的版本。高 16 位包含主版本号，低 16 位包含次要版本号。

[out] Flags

将此设置为零。 (保留以供将来使用。)

返回代码	说明
S_OK	扩展已成功初始化。

任何其他值指示扩展 DLL 无法初始化，引擎将卸载它。

引擎在每个扩展 DLL 中按名称查找此函数。此函数必须由 DbgEng 扩展 DLL 导出。

可以使用 dbgeng.h 中的宏DEBUG_EXTENSION_VERSION设置版本号，例如：

*Version = DEBUG_EXTENSION_VERSION(Major, Minor)

此函数的实现应初始化扩展 DLL 所需的任何全局变量。

调用此函数时，会话可能处于活动状态，也可能没有活动会话，因此扩展不应假定它能够查询会话信息。

函数类型定义为 dbgeng.h 中的 PDEBUG_EXTENSION_INITIALIZE。

要求	值
目标平台	通用
标头	dbgeng.h