Partager via

IDebugEventCallbacksWide ::ChangeSymbolState, méthode (dbgeng.h)

  • Article

La méthode de rappel ChangeSymbolState est appelée par le moteur lorsque l’état du symbole change.

Syntaxe

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

Paramètres

[in] Flags

Spécifie un jeu de bits indiquant la nature de la modification de l’état du symbole. Les indicateurs de bits suivants peuvent être définis.

Valeur Description
DEBUG_CSS_LOADS Le moteur a chargé certains symboles de module.
DEBUG_CSS_UNLOADS Le moteur a déchargé certains symboles de module.
DEBUG_CSS_SCOPE L’étendue du symbole actuel a changé.
DEBUG_CSS_PATHS L’image exécutable, la source ou les chemins de recherche de symboles ont changé.
DEBUG_CSS_SYMBOL_OPTIONS Les options de symboles ont changé.
DEBUG_CSS_TYPE_OPTIONS Les options de type ont changé.

[in] Argument

Fournit des informations supplémentaires sur la modification de l’état du symbole. Si plusieurs indicateurs de bits sont définis dans le paramètre indicateurs de, le paramètre Argument n’est pas utilisé. Sinon, la valeur de argument dépend de la valeur des indicateurs de :

DEBUG_CSS_LOADS

La valeur de Argument est l’emplacement de base (dans l’espace d’adressage mémoire de la cible) de l’image de module pour laquelle le moteur a chargé des symboles.

DEBUG_CSS_UNLOADS

La valeur de Argument est l’emplacement de base (dans l’espace d’adressage mémoire de la cible) de l’image de module pour laquelle le moteur a déchargé des symboles. Si le moteur a déchargé des symboles pour plusieurs images, la valeur de Argument est égale à zéro.

DEBUG_CSS_SCOPE

La valeur de argument est égale à zéro.

DEBUG_CSS_PATHS

La valeur de argument est égale à zéro.

DEBUG_CSS_SYMBOL_OPTIONS

La valeur de argument est les options de symbole.

DEBUG_CSS_TYPE_OPTIONS

La valeur de argument est égale à zéro.

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_SYMBOL_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)