PDEBUG_EXTENSION_NOTIFY función de devolución de llamada (dbgeng.h)
El motor llama a la función de devolución de llamada DebugExtensionNotify para informar al archivo DLL de extensión cuando una sesión cambia su estado activo o accesible.
CALLBACK* PDEBUG_EXTENSION_NOTIFY DebugExtensionNotify;
Sintaxis
PDEBUG_EXTENSION_NOTIFY PdebugExtensionNotify;
void PdebugExtensionNotify(
[in] ULONG Notify,
[in] ULONG64 Argument
)
{...}
Parámetros
[in] Notify
Puede ser cualquiera de los valores siguientes:
| Valor | Descripción |
|---|---|
| DEBUG_NOTIFY_SESSION_ACTIVE | Una sesión de depuración está activa. Es posible que la sesión no se suspenda necesariamente. |
| DEBUG_NOTIFY_SESSION_INACTIVE | No hay ninguna sesión de depuración activa. |
| DEBUG_NOTIFY_SESSION_ACCESSIBLE | La sesión de depuración se ha suspendido y ahora es accesible. |
| DEBUG_NOTIFY_SESSION_INACCESSIBLE | La sesión de depuración ha empezado a ejecutarse y ahora no es accesible. |
[in] Argument
Establecer en cero. (Reservado para uso futuro).
Valor devuelto
None
Observaciones
Esta función es opcional. Un archivo DLL de extensión DbgEng solo debe exportar DebugExtensionNotify si quiere recibir una notificación cuando cambia el estado de sesión. El motor busca esta función por nombre en el archivo DLL de extensión.
Esta función permite que el archivo DLL de extensión almacene en caché información sobre la sesión sin necesidad de registrar devoluciones de llamada explícitas. Se llama al principio y al final de una sesión, y cada vez que un destino se inicia o deja de ejecutarse.
Una vez inicializado el archivo DLL de extensión, el motor usará esta función para notificar al archivo DLL si ha iniciado una sesión. Si se suspende la sesión actual, el motor llamará a esta función una segunda vez para notificar al archivo DLL que es accesible la sesión.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | dbgeng.h |