Compartilhar via

PDEBUG_EXTENSION_NOTIFY função de retorno de chamada (dbgeng.h)

  • Artigo

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

Confira também

DebugExtensionInitialize