PDEBUG_EXTENSION_NOTIFY Rückruffunktion (dbgeng.h)
Das Modul ruft die Rückruffunktion DebugExtensionNotify auf, um die Erweiterungs-DLL zu informieren, wenn eine Sitzung ihre aktive oder zugängliche status ändert.
CALLBACK* PDEBUG_EXTENSION_NOTIFY DebugExtensionNotify;
Syntax
PDEBUG_EXTENSION_NOTIFY PdebugExtensionNotify;
void PdebugExtensionNotify(
[in] ULONG Notify,
[in] ULONG64 Argument
)
{...}
Parameter
[in] Notify
Es kann sich um einen der folgenden Werte handeln:
| Wert | BESCHREIBUNG |
|---|---|
| DEBUG_NOTIFY_SESSION_ACTIVE | Eine Debugsitzung ist aktiv. Die Sitzung wird möglicherweise nicht unbedingt angehalten. |
| DEBUG_NOTIFY_SESSION_INACTIVE | Es ist keine Debugsitzung aktiv. |
| DEBUG_NOTIFY_SESSION_ACCESSIBLE | Die Debugsitzung wurde angehalten und ist jetzt zugänglich. |
| DEBUG_NOTIFY_SESSION_INACCESSIBLE | Die Debugsitzung wurde ausgeführt und kann nicht mehr zugegriffen werden. |
[in] Argument
Auf NULL festlegen. (Für zukünftige Verwendung reserviert.)
Rückgabewert
Keine
Bemerkungen
Diese Funktion ist optional. Eine DbgEng-Erweiterungs-DLL muss DebugExtensionNotify nur exportieren, wenn sie benachrichtigt werden möchte, wenn sich der Sitzungsstatus ändert. Die Engine 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. Es wird zu Beginn 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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| Header | dbgeng.h |