PDEBUG_EXTENSION_INITIALIZE función de devolución de llamada (dbgeng.h)
El motor llama a la función de devolución de llamada DebugExtensionInitialize después de cargar un archivo DLL de extensión DbgEng.
CALLBACK* PDEBUG_EXTENSION_INITIALIZE DebugExtensionInitialize;
Sintaxis
PDEBUG_EXTENSION_INITIALIZE PdebugExtensionInitialize;
HRESULT PdebugExtensionInitialize(
[out] PULONG Version,
[out] PULONG Flags
)
{...}
Parámetros
[out] Version
Recibe la versión de la extensión. Los 16 bits altos contienen el número de versión principal y los 16 bits bajos contienen el número de versión secundaria.
[out] Flags
Establézcalo en cero. (Reservado para uso futuro).
Valor devuelto
| Código devuelto | Descripción |
|---|---|
|
La extensión se inicializó correctamente. |
Cualquier otro valor indica que el archivo DLL de extensión no pudo inicializarse y el motor lo descargará.
Observaciones
El motor busca esta función por nombre en cada archivo DLL de extensión. Esta función debe exportarse mediante un archivo DLL de extensión DbgEng.
El número de versión se puede establecer mediante la macro DEBUG_EXTENSION_VERSION que se encuentra en dbgeng.h, por ejemplo:
*Version = DEBUG_EXTENSION_VERSION(Major, Minor)
Las implementaciones de esta función deben inicializar las variables globales necesarias para el archivo DLL de extensión.
Puede haber o no una sesión activa cuando se llama a esta función, por lo que la extensión no debe suponer que puede consultar la información de la sesión.
El tipo de función se define como PDEBUG_EXTENSION_INITIALIZE en dbgeng.h.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| encabezado de | dbgeng.h |