PDEBUG_EXTENSION_NOTIFY funzione di callback (dbgeng.h)
Il motore chiama la funzione di callback DebugExtensionNotify per informare la DLL dell'estensione quando una sessione modifica lo stato attivo o accessibile.
CALLBACK* PDEBUG_EXTENSION_NOTIFY DebugExtensionNotify;
Sintassi
PDEBUG_EXTENSION_NOTIFY PdebugExtensionNotify;
void PdebugExtensionNotify(
[in] ULONG Notify,
[in] ULONG64 Argument
)
{...}
Parametri
[in] Notify
Può essere uno dei valori seguenti:
| Valore | Descrizione |
|---|---|
| DEBUG_NOTIFY_SESSION_ACTIVE | Una sessione di debug è attiva. La sessione potrebbe non essere necessariamente sospesa. |
| DEBUG_NOTIFY_SESSION_INACTIVE | Nessuna sessione di debug attiva. |
| DEBUG_NOTIFY_SESSION_ACCESSIBLE | La sessione di debug è stata sospesa ed è ora accessibile. |
| DEBUG_NOTIFY_SESSION_INACCESSIBLE | La sessione di debug è stata avviata ed è ora inaccessibile. |
[in] Argument
Imposta su zero. (Riservato per uso futuro).
Valore restituito
nessuno
Osservazioni
Questa funzione è facoltativa. Una DLL dell'estensione DbgEng deve solo esportare DebugExtensionNotify se vuole ricevere una notifica quando lo stato della sessione cambia. Il motore cerca questa funzione in base al nome nella DLL dell'estensione.
Questa funzione consente alla DLL dell'estensione di memorizzare nella cache le informazioni sulla sessione senza dover registrare callback espliciti. Viene chiamato all'inizio e alla fine di una sessione e ogni volta che una destinazione inizia o arresta l'esecuzione.
Dopo l'inizializzazione della DLL dell'estensione, il motore userà questa funzione per notificare alla DLL se ha avviato una sessione. Se la sessione corrente è sospesa, il motore chiamerà questa funzione una seconda volta per notificare alla DLL che la sessione è accessibile.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Intestazione | dbgeng.h |