función de devolución de llamada PDEBUG_EXTENSION_NOTIFY (dbgeng.h)
El motor llama a la función de devolución de llamada DebugExtensionNotify para informar a la extensión DLL 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 siguientes valores:
| 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
Establézcalo en cero. (Reservado para uso futuro).
Valor devuelto
Ninguno
Observaciones
Esta función es opcional. Un archivo DLL de extensión DbgEng solo necesita 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 la sesión es accesible.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| encabezado de | dbgeng.h |