IDebugEventCallbacksWide ::ChangeEngineState, méthode (dbgeng.h)
La méthode de rappel ChangeEngineState est appelée par le moteur lorsque son état a changé.
Syntaxe
HRESULT ChangeEngineState(
[in] ULONG Flags,
[in] ULONG64 Argument
);
Paramètres
[in] Flags
Spécifie un jeu de bits indiquant le type de modifications qui se sont produites dans l’état du moteur. Les indicateurs de bits suivants peuvent être définis :
| Valeur | Description |
|---|---|
| DEBUG_CES_CURRENT_THREAD | Le thread actuel a changé, ce qui implique que la cible actuelle et le processus actuel aient également changé. |
| DEBUG_CES_EFFECTIVE_PROCESSOR | Le processeur effectif a changé. |
| DEBUG_CES_BREAKPOINTS | Un ou plusieurs points d’arrêt ont changé. |
| DEBUG_CES_CODE_LEVEL | Le niveau d’interprétation du code a changé. |
| DEBUG_CES_EXECUTION_STATUS | L’état d’exécution a changé. |
| DEBUG_CES_ENGINE_OPTIONS | Les options du moteur ont changé. |
| DEBUG_CES_LOG_FILE | Le fichier journal a été ouvert ou fermé. |
| DEBUG_CES_RADIX | Le radix par défaut a changé. |
| DEBUG_CES_EVENT_FILTERS | Les filtres d’événements ont changé. |
| DEBUG_CES_PROCESS_OPTIONS | Les options de processus pour le processus actuel ont changé. |
| DEBUG_CES_EXTENSIONS | Les DLL d’extension ont été chargées ou déchargées. (Pour plus d’informations, consultez chargement des DLL d’extension de débogueur.) |
| DEBUG_CES_SYSTEMS | Une cible a été ajoutée ou supprimée. |
| DEBUG_CES_ASSEMBLY_OPTIONS | Les options d’assemblage ont changé. |
| DEBUG_CES_EXPRESSION_SYNTAX | La syntaxe d’expression par défaut a changé. |
| DEBUG_CES_TEXT_REPLACEMENTS | Les remplacements de texte ont changé. |
[in] Argument
Fournit des informations supplémentaires sur la modification de l’état du moteur. Si plusieurs indicateurs de bits sont définis dans le paramètre indicateurs de, le paramètre Argument n’est pas utilisé. Dans le cas contraire, l’interprétation de la valeur de Argument dépend de la valeur des indicateurs de :
DEBUG_CES_CURRENT_THREAD
La valeur de 'argument est l’ID de thread du moteur actuel ou- s’il n’existe pas de thread--DEBUG_ANY_ID actuel. Pour plus d’informations, consultez threads et processus.
DEBUG_CES_EFFECTIVE_PROCESSOR
La valeur de argument est le type du processeur effectif.
DEBUG_CES_BREAKPOINTS
La valeur de Argument est l’ID de point d’arrêt du point d’arrêt qui a été modifié ou, si plusieurs points d’arrêt ont été modifiés, DEBUG_ANY_ID. Pour plus d’informations, consultez points d’arrêt.
DEBUG_CES_CODE_LEVEL
La valeur de argument est le niveau d’interprétation du code.
DEBUG_CES_EXECUTION_STATUS
La valeur de argument est l’état d’exécution (comme décrit dans la rubrique DEBUG_STATUS_XXX) éventuellement combiné à l’indicateur de bits DEBUG_STATUS_INSIDE_WAIT. DEBUG_STATUS_INSIDE_WAIT est défini lorsqu’un appel WaitForEvent est en attente. Pour plus d’informations, consultez débogage de session et de modèle d’exécution.
DEBUG_CES_ENGINE_OPTIONS
La valeur de argument est les options du moteur.
DEBUG_CES_LOG_FILE
La valeur de Argument est TRUE si le fichier journal a été ouvert et FALSE si le fichier journal a été fermé.
DEBUG_CES_RADIX
La valeur de Argument est le rayon par défaut.
DEBUG_CES_EVENT_FILTERS
La valeur de Argument est l’index du filtre d’événements qui a été modifié ou- si plusieurs filtres d’événements ont été modifiés--DEBUG_ANY_ID.
DEBUG_CES_PROCESS_OPTIONS
La valeur de 'argument est les options de processus pour le processus actuel.
DEBUG_CES_EXTENSIONS
La valeur de argument est égale à zéro.
DEBUG_CES_SYSTEMS
La valeur de Argument est l’ID cible de la cible qui a été ajoutée ou--si une cible a été supprimée--DEBUG_ANY_ID.
DEBUG_CES_ASSEMBLE_OPTIONS
La valeur de argument est les options d’assemblage.
DEBUG_CES_EXPRESSION_SYNTAX
La valeur de Argument est la syntaxe d’expression par défaut.
DEBUG_CES_TEXT_REPLACEMENTS
La valeur de argument est DEBUG_ANY_ID.
Valeur de retour
La valeur de retour est ignorée par le moteur, sauf si elle indique une erreur d’appel de procédure distante ; dans ce cas, le client, avec lequel cet objet IDebugEventCallbacksWide est inscrit, est désactivé.
Remarques
Cette méthode est appelée uniquement par le moteur si l’indicateur DEBUG_EVENT_CHANGE_ENGINE_STATE est défini dans le masque retourné par IDebugEventCallbacksWide ::GetInterestMask.
Pour plus d’informations sur la gestion des événements, consultez Monitoring Events.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | dbgeng.h (include Dbgeng.h) |