IMAGE_DEBUG_INFORMATION structure (dbghelp.h)

Article
08/23/2023

Contient les informations de débogage.

Note Cette structure est utilisée par les fonctions MapDebugInformation et UnmapDebugInformation , qui sont fournies uniquement à des fins de compatibilité descendante.

Syntaxe

typedef struct _IMAGE_DEBUG_INFORMATION {
  LIST_ENTRY                 List;
  DWORD                      ReservedSize;
  PVOID                      ReservedMappedBase;
  USHORT                     ReservedMachine;
  USHORT                     ReservedCharacteristics;
  DWORD                      ReservedCheckSum;
  DWORD                      ImageBase;
  DWORD                      SizeOfImage;
  DWORD                      ReservedNumberOfSections;
  PIMAGE_SECTION_HEADER      ReservedSections;
  DWORD                      ReservedExportedNamesSize;
  PSTR                       ReservedExportedNames;
  DWORD                      ReservedNumberOfFunctionTableEntries;
  PIMAGE_FUNCTION_ENTRY      ReservedFunctionTableEntries;
  DWORD                      ReservedLowestFunctionStartingAddress;
  DWORD                      ReservedHighestFunctionEndingAddress;
  DWORD                      ReservedNumberOfFpoTableEntries;
  PFPO_DATA                  ReservedFpoTableEntries;
  DWORD                      SizeOfCoffSymbols;
  PIMAGE_COFF_SYMBOLS_HEADER CoffSymbols;
  DWORD                      ReservedSizeOfCodeViewSymbols;
  PVOID                      ReservedCodeViewSymbols;
  PSTR                       ImageFilePath;
  PSTR                       ImageFileName;
  PSTR                       ReservedDebugFilePath;
  DWORD                      ReservedTimeDateStamp;
  BOOL                       ReservedRomImage;
  PIMAGE_DEBUG_DIRECTORY     ReservedDebugDirectory;
  DWORD                      ReservedNumberOfDebugDirectories;
  DWORD                      ReservedOriginalFunctionTableBaseAddress;
  DWORD                      Reserved[2];
} IMAGE_DEBUG_INFORMATION, *PIMAGE_DEBUG_INFORMATION;

Membres

List

Liste liée de structures LIST_ENTRY .

ReservedSize

Taille de la mémoire allouée à la structure IMAGE_DEBUG_INFORMATION et toutes les informations de débogage, en octets.

ReservedMappedBase

Adresse de base de l’image.

ReservedMachine

Type d’ordinateur. Ce membre peut être l’une des valeurs suivantes.

Valeur	Signification
IMAGE_FILE_MACHINE_I386 0x014c	Intel (32 bits)
IMAGE_FILE_MACHINE_IA64 0x0200	Intel Itanium
IMAGE_FILE_MACHINE_AMD64 0x8664	x64 (AMD64 ou EM64T)

ReservedCharacteristics

Caractéristiques de l’image. Ce membre peut être l’une des valeurs suivantes.

Valeur	Signification
IMAGE_FILE_RELOCS_STRIPPED 0x0001	Les informations de relocalisation sont supprimées du fichier.
IMAGE_FILE_EXECUTABLE_IMAGE 0x0002	Le fichier est exécutable (il n’existe aucune référence externe non résolue).
IMAGE_FILE_LINE_NUMS_STRIPPED 0x0004	Les numéros de ligne sont supprimés du fichier.
IMAGE_FILE_LOCAL_SYMS_STRIPPED 0x0008	Les symboles locaux sont supprimés du fichier.
IMAGE_FILE_AGGRESIVE_WS_TRIM 0x0010	Réduisez de façon agressive le jeu de travail.
IMAGE_FILE_LARGE_ADDRESS_AWARE 0x0020	L’application peut gérer des adresses supérieures à 2 Go.
IMAGE_FILE_BYTES_REVERSED_LO 0x0080	Les octets du mot sont inversés.
IMAGE_FILE_32BIT_MACHINE 0x0100	L’ordinateur prend en charge les mots 32 bits.
IMAGE_FILE_DEBUG_STRIPPED 0x0200	Les informations de débogage sont stockées séparément dans un fichier .dbg.
IMAGE_FILE_REMOVABLE_RUN_FROM_SWAP 0x0400	Si l’image se trouve sur un support amovible, copiez et exécutez à partir du fichier d’échange.
IMAGE_FILE_NET_RUN_FROM_SWAP 0x0800	Si l’image se trouve sur le réseau, copiez et exécutez à partir du fichier d’échange.
IMAGE_FILE_SYSTEM 0x1000	Fichier système.
IMAGE_FILE_DLL 0x2000	Fichier DLL.
IMAGE_FILE_UP_SYSTEM_ONLY 0x4000	Le fichier doit être exécuté uniquement sur un ordinateur monoprocesseur.
IMAGE_FILE_BYTES_REVERSED_HI 0x8000	Les octets du mot sont inversés.

ReservedCheckSum

Somme de contrôle de l’image.

ImageBase

Adresse de base demandée de l’image.

SizeOfImage

Taille de l’image, en octets.

ReservedNumberOfSections

Nombre d’en-têtes de section COFF.

ReservedSections

Pointeur vers le premier en-tête de section COFF. Pour plus d’informations, consultez IMAGE_SECTION_HEADER.

ReservedExportedNamesSize

Taille du membre ExportedNames , en octets.

ReservedExportedNames

Pointeur vers une série de chaînes terminées par null qui nomment toutes les fonctions exportées à partir de l’image.

ReservedNumberOfFunctionTableEntries

Nombre d’entrées contenues dans le membre FunctionTableEntries .

ReservedFunctionTableEntries

Pointeur vers la première entrée de table de fonctions. Pour plus d’informations, consultez IMAGE_FUNCTION_ENTRY.

ReservedLowestFunctionStartingAddress

Adresse de départ de la table de fonctions la plus basse.

ReservedHighestFunctionEndingAddress

Adresse de fin de table de fonctions la plus élevée.

ReservedNumberOfFpoTableEntries

Nombre d’entrées contenues dans le membre FpoTableEntries .

ReservedFpoTableEntries

Pointeur vers la première entrée FPO. Pour plus d’informations, consultez FPO_DATA.

SizeOfCoffSymbols

Taille de la table de symboles COFF, en octets.

CoffSymbols

Pointeur vers la table de symboles COFF.

ReservedSizeOfCodeViewSymbols

Taille de la table de symboles CodeView, en octets.

ReservedCodeViewSymbols

Pointeur vers le début de la table de symboles CodeView.

ImageFilePath

Chemin d’accès relatif au nom du fichier image.

ImageFileName

Nom du fichier image.

ReservedDebugFilePath

Chemin d’accès complet au fichier de symboles.

ReservedTimeDateStamp

Horodatage de l’image. Cela représente la date et l’heure de création de l’image par l’éditeur de liens.

ReservedRomImage

Cette valeur est TRUE si l’image est une image ROM.

ReservedDebugDirectory

Pointeur vers le premier répertoire de débogage. Pour plus d’informations, consultez IMAGE_DEBUG_DIRECTORY.

ReservedNumberOfDebugDirectories

Nombre d’entrées contenues dans le membre DebugDirectory .

ReservedOriginalFunctionTableBaseAddress

Adresse de base de la table de fonction d’origine.

Reserved[2]

Ce membre est réservé au système d’exploitation.

Remarques

La structure LIST_ENTRY est définie comme suit :

typedef struct _LIST_ENTRY {
   struct _LIST_ENTRY *Flink;
   struct _LIST_ENTRY *Blink;
} LIST_ENTRY, *PLIST_ENTRY, *RESTRICTED_POINTER PRLIST_ENTRY;