PDEBUG_EXTENSION_NOTIFY função de retorno de chamada (dbgeng.h)
O mecanismo chama a função de retorno de chamada DebugExtensionNotify para informar a DLL da extensão quando uma sessão altera sua status ativa ou acessível.
CALLBACK* PDEBUG_EXTENSION_NOTIFY DebugExtensionNotify;
Sintaxe
PDEBUG_EXTENSION_NOTIFY PdebugExtensionNotify;
void PdebugExtensionNotify(
[in] ULONG Notify,
[in] ULONG64 Argument
)
{...}
Parâmetros
[in] Notify
Pode ser qualquer um dos seguintes valores:
| Valor | Descrição |
|---|---|
| DEBUG_NOTIFY_SESSION_ACTIVE | Uma sessão de depuração está ativa. A sessão pode não ser necessariamente suspensa. |
| DEBUG_NOTIFY_SESSION_INACTIVE | Nenhuma sessão de depuração está ativa. |
| DEBUG_NOTIFY_SESSION_ACCESSIBLE | A sessão de depuração foi suspensa e agora está acessível. |
| DEBUG_NOTIFY_SESSION_INACCESSIBLE | A sessão de depuração começou a ser executada e agora está inacessível. |
[in] Argument
Defina como zero. (Reservado para uso futuro.)
Retornar valor
Nenhum
Comentários
Essa função é opcional. Uma DLL de extensão DbgEng só precisa exportar DebugExtensionNotify se quiser ser notificada quando o estado da sessão for alterado. O mecanismo procura essa função por nome na DLL de extensão.
Essa função permite que a DLL de extensão armazene em cache informações sobre a sessão sem a necessidade de registrar retornos de chamada explícitos. Ele é chamado no início e no final de uma sessão e sempre que um destino é iniciado ou para de ser executado.
Depois que a DLL de extensão for inicializada, o mecanismo usará essa função para notificar a DLL se ela tiver iniciado uma sessão. Se a sessão atual for suspensa, o mecanismo chamará essa função uma segunda vez para notificar a DLL de que a sessão está acessível.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Cabeçalho | dbgeng.h |