Méthode IDebugSymbols3 ::GetSymbolEntryOffsetRegions (dbgeng.h)

  • Article

Retourne toutes les régions de mémoire connues pour être associées à un symbole.

Syntaxe

HRESULT GetSymbolEntryOffsetRegions(
  [in]            PDEBUG_MODULE_AND_ID Id,
  [in]            ULONG                Flags,
  [out]           PDEBUG_OFFSET_REGION Regions,
  [in]            ULONG                RegionsCount,
  [out, optional] PULONG               RegionsAvail
);

Paramètres

[in] Id

ID d’un module en tant que pointeur vers une structure DEBUG_MODULE_AND_ID .

[in] Flags

Jeu de bits qui contient des options qui affectent le comportement de cette méthode.

[out] Regions

Régions de mémoire associées au symbole.

[in] RegionsCount

Nombre de régions associées au symbole.

[out, optional] RegionsAvail

Pointeur vers le nombre de régions disponibles pour le symbole.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Cette fonction retourne toutes les régions de mémoire connues associées à un symbole spécifié. Les symboles simples ont une seule région qui commence à partir de leur base. Les régions plus complexes, telles que les fonctions qui ont plusieurs zones de code, peuvent avoir un nombre arbitrairement élevé de régions.

La qualité des informations retournées dépend fortement de l’information symbolique disponible.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête dbgeng.h (inclure Dbgeng.h)

Voir aussi

DEBUG_MODULE_AND_ID

IDebugSymbols3

IDebugSymbols3 ::GetSourceEntryOffsetRegions