Metodo IDebugEventCallbacks::ChangeEngineState (dbgeng.h)

Il metodo di callback ChangeEngineState viene chiamato dal motore quando il relativo stato è cambiato.

Sintassi

HRESULT ChangeEngineState(
  [in] ULONG   Flags,
  [in] ULONG64 Argument
);

Parametri

[in] Flags

Specifica un set di bit che indica il tipo di modifiche che si sono verificate nello stato del motore. È possibile impostare i flag di bit seguenti:

Valore	Descrizione
DEBUG_CES_CURRENT_THREAD	Il thread corrente è stato modificato, il che implica che anche la destinazione corrente e il processo corrente potrebbero essere stati modificati.
DEBUG_CES_EFFECTIVE_PROCESSOR	Il processore effettivo è cambiato.
DEBUG_CES_BREAKPOINTS	Uno o più punti di interruzione sono stati modificati.
DEBUG_CES_CODE_LEVEL	Il livello di interpretazione del codice è cambiato.
DEBUG_CES_EXECUTION_STATUS	Lo stato di esecuzione è stato modificato.
DEBUG_CES_ENGINE_OPTIONS	Le opzioni del motore sono state modificate.
DEBUG_CES_LOG_FILE	Il file di log è stato aperto o chiuso.
DEBUG_CES_RADIX	Il radix predefinito è stato modificato.
DEBUG_CES_EVENT_FILTERS	I filtri eventi sono stati modificati.
DEBUG_CES_PROCESS_OPTIONS	Le opzioni di processo per il processo corrente sono state modificate.
DEBUG_CES_EXTENSIONS	Le DLL di estensione sono state caricate o scaricate. Per altre informazioni, vedere Caricamento delle DLL dell'estensione del debugger.
DEBUG_CES_SYSTEMS	È stata aggiunta o rimossa una destinazione.
DEBUG_CES_ASSEMBLY_OPTIONS	Le opzioni di assemblaggio sono state modificate.
DEBUG_CES_EXPRESSION_SYNTAX	La sintassi dell'espressione predefinita è stata modificata.
DEBUG_CES_TEXT_REPLACEMENTS	Le sostituzioni di testo sono state modificate.

[in] Argument

Fornisce informazioni aggiuntive sulla modifica allo stato del motore. Se nel parametro Flags sono impostati più flag di bit, il parametro Argument non viene utilizzato. In caso contrario, l'interpretazione del valore di Argument dipende dal valore di Flags:

DEBUG_CES_CURRENT_THREAD

Il valore di Argument è l'ID thread del motore corrente o, se non è presente alcun thread corrente, DEBUG_ANY_ID. Per altre informazioni, vedere Thread e processi.

DEBUG_CES_EFFECTIVE_PROCESSOR

Il valore di Argument è il tipo del processore effettivo.

DEBUG_CES_BREAKPOINTS

Il valore di Argument è l'ID del punto di interruzione del punto di interruzione modificato o, se è stato modificato più di un punto di interruzione, DEBUG_ANY_ID. Per altre informazioni, vedere Punti di interruzione.

DEBUG_CES_CODE_LEVEL

Il valore di Argument è il livello di interpretazione del codice.

DEBUG_CES_EXECUTION_STATUS

Il valore di Argument è lo stato di esecuzione (come descritto nell'argomento DEBUG_STATUS_XXX ) possibilmente combinato con il flag di bit DEBUG_STATUS_INSIDE_WAIT. DEBUG_STATUS_INSIDE_WAIT viene impostato quando una chiamata WaitForEvent è in sospeso. Per altre informazioni, vedere Debug di sessioni ed esecuzione del modello.

DEBUG_CES_ENGINE_OPTIONS

Il valore di Argument è rappresentato dalle opzioni del motore.

DEBUG_CES_LOG_FILE

Il valore di Argument è TRUE se il file di log è stato aperto e FALSE se il file di log è stato chiuso.

DEBUG_CES_RADIX

Il valore di Argument è il radix predefinito.

DEBUG_CES_EVENT_FILTERS

Il valore di Argument è l'indice del filtro eventi modificato o, se più filtri eventi sono stati modificati, DEBUG_ANY_ID.

DEBUG_CES_PROCESS_OPTIONS

Il valore di Argument è le opzioni di processo per il processo corrente.

DEBUG_CES_EXTENSIONS

Il valore di Argument è zero.

DEBUG_CES_SYSTEMS

Il valore di Argument è l'ID di destinazione della destinazione aggiunta o, se una destinazione è stata rimossa, DEBUG_ANY_ID.

DEBUG_CES_ASSEMBLE_OPTIONS

Il valore di Argument è le opzioni di assemblaggio.

DEBUG_CES_EXPRESSION_SYNTAX

Il valore di Argument è la sintassi dell'espressione predefinita.

DEBUG_CES_TEXT_REPLACEMENTS

Il valore di Argument è DEBUG_ANY_ID.

Valore restituito

Il valore restituito viene ignorato dal motore a meno che non indichi un errore di chiamata di procedura remota; in questo caso il client, con cui viene registrato l'oggetto IDebugEventCallbacks , è disabilitato.

Commenti

Questo metodo viene chiamato solo dal motore se il flag DEBUG_EVENT_CHANGE_ENGINE_STATE è impostato nella maschera restituita da IDebugEventCallbacks::GetInterestMask.

Per altre informazioni sulla gestione degli eventi, vedere Monitoraggio degli eventi.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	dbgeng.h (include Dbgeng.h)