PDEBUG_EXTENSION_NOTIFY Rückruffunktion (dbgeng.h)
Das Modul ruft die DebugExtensionNotify Rückruffunktion auf, um die Erweiterung DLL- zu informieren, wenn eine Sitzung ihren aktiven oder barrierefreien Status ändert.
CALLBACK* PDEBUG_EXTENSION_NOTIFY DebugExtensionNotify;
PDEBUG_EXTENSION_NOTIFY PdebugExtensionNotify;
void PdebugExtensionNotify(
[in] ULONG Notify,
[in] ULONG64 Argument
)
{...}
[in] Notify
Dies kann eine der folgenden Werte sein:
| Wert | Beschreibung |
|---|---|
| DEBUG_NOTIFY_SESSION_ACTIVE | Eine Debugsitzung ist aktiv. Die Sitzung kann möglicherweise nicht unbedingt angehalten werden. |
| DEBUG_NOTIFY_SESSION_INACTIVE | Keine Debugsitzung ist aktiv. |
| DEBUG_NOTIFY_SESSION_ACCESSIBLE | Die Debugsitzung wurde angehalten und ist jetzt verfügbar. |
| DEBUG_NOTIFY_SESSION_INACCESSIBLE | Die Debugsitzung wurde gestartet und kann jetzt nicht mehr verwendet werden. |
[in] Argument
Auf Null festgelegt. (Reserviert für zukünftige Verwendung.)
Nichts
Diese Funktion ist optional. Eine DbgEng-Erweiterungs-DLL muss nur DebugExtensionNotify exportieren, wenn sie benachrichtigt werden möchte, wenn sich der Sitzungszustand ändert. Das Modul sucht diese Funktion anhand des Namens in der Erweiterungs-DLL.
Mit dieser Funktion kann die Erweiterungs-DLL Informationen zur Sitzung zwischenspeichern, ohne explizite Rückrufe registrieren zu müssen. Sie wird am Anfang und Ende einer Sitzung aufgerufen, und jedes Mal, wenn ein Ziel gestartet oder beendet wird.
Nachdem die Erweiterungs-DLL initialisiert wurde, verwendet das Modul diese Funktion, um die DLL zu benachrichtigen, wenn sie eine Sitzung gestartet hat. Wenn die aktuelle Sitzung angehalten wird, ruft das Modul diese Funktion ein zweites Mal auf, um die DLL zu benachrichtigen, dass auf die Sitzung zugegriffen werden kann.
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Header- | dbgeng.h |