PDEBUG_EXTENSION_INITIALIZE função de retorno de chamada (dbgeng.h)
A função de retorno de chamada DebugExtensionInitialize é chamada pelo mecanismo depois de carregar uma DLL de extensão DbgEng.
CALLBACK* PDEBUG_EXTENSION_INITIALIZE DebugExtensionInitialize;
Sintaxe
PDEBUG_EXTENSION_INITIALIZE PdebugExtensionInitialize;
HRESULT PdebugExtensionInitialize(
[out] PULONG Version,
[out] PULONG Flags
)
{...}
Parâmetros
[out] Version
Recebe a versão da extensão. Os 16 bits altos contêm o número de versão principal e os 16 bits baixos contêm o número de versão secundária.
[out] Flags
Defina isso como zero. (Reservado para uso futuro.)
Valor de retorno
| Código de retorno | Descrição |
|---|---|
|
A extensão foi inicializada com êxito. |
Qualquer outro valor indica que a DLL de extensão não pôde ser inicializada e o mecanismo a descarregará.
Observações
O mecanismo procura essa função pelo nome em cada DLL de extensão. Essa função deve ser exportada por uma DLL de extensão DbgEng.
O número de versão pode ser definido usando a macro DEBUG_EXTENSION_VERSION encontrada em dbgeng.h, por exemplo:
*Version = DEBUG_EXTENSION_VERSION(Major, Minor)
As implementações dessa função devem inicializar todas as variáveis globais exigidas pela DLL de extensão.
Pode ou não haver uma sessão ativa quando essa função é chamada, portanto, a extensão não deve assumir que é capaz de consultar informações da sessão.
O tipo de função é definido como PDEBUG_EXTENSION_INITIALIZE em dbgeng.h.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| cabeçalho | dbgeng.h |