IMAGE_DEBUG_INFORMATION-Struktur (dbghelp.h)

Artikel
02/27/2024

Enthält Debuginformationen.

Hinweis Diese Struktur wird von den Funktionen MapDebugInformation und UnmapDebugInformation verwendet, die nur aus Gründen der Abwärtskompatibilität bereitgestellt werden.

Syntax

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;

Member

List

Eine verknüpfte Liste von LIST_ENTRY Strukturen.

ReservedSize

Die Größe des Arbeitsspeichers, der für die IMAGE_DEBUG_INFORMATION Struktur und alle Debuginformationen in Bytes zugewiesen ist.

ReservedMappedBase

Die Basisadresse des Images.

ReservedMachine

Der Computertyp. Dieser Member kann einer der folgenden Werte sein.

Wert	Bedeutung
IMAGE_FILE_MACHINE_I386 0x014c	Intel (32-Bit)
IMAGE_FILE_MACHINE_IA64 0x0200	Intel Itanium
IMAGE_FILE_MACHINE_AMD64 0x8664	x64 (AMD64 oder EM64T)

ReservedCharacteristics

Die Merkmale des Bilds. Dieser Member kann einer der folgenden Werte sein.

Wert	Bedeutung
IMAGE_FILE_RELOCS_STRIPPED 0x0001	Umzugsinformationen werden aus der Datei entfernt.
IMAGE_FILE_EXECUTABLE_IMAGE 0x0002	Die Datei ist ausführbar (es gibt keine ungelösten externen Verweise).
IMAGE_FILE_LINE_NUMS_STRIPPED 0x0004	Zeilennummern werden aus der Datei entfernt.
IMAGE_FILE_LOCAL_SYMS_STRIPPED 0x0008	Lokale Symbole werden aus der Datei entfernt.
IMAGE_FILE_AGGRESIVE_WS_TRIM 0x0010	Kürzen Sie den Arbeitssatz aggressiv.
IMAGE_FILE_LARGE_ADDRESS_AWARE 0x0020	Die Anwendung kann Adressen verarbeiten, die größer als 2 GB sind.
IMAGE_FILE_BYTES_REVERSED_LO 0x0080	Bytes des Worts werden umgekehrt.
IMAGE_FILE_32BIT_MACHINE 0x0100	Computer unterstützt 32-Bit-Wörter.
IMAGE_FILE_DEBUG_STRIPPED 0x0200	Debuginformationen werden separat in einer DBG-Datei gespeichert.
IMAGE_FILE_REMOVABLE_RUN_FROM_SWAP 0x0400	Wenn sich das Image auf Wechselmedien befindet, kopieren Sie die Auslagerungsdatei, und führen Sie es aus.
IMAGE_FILE_NET_RUN_FROM_SWAP 0x0800	Wenn sich das Image im Netzwerk befindet, kopieren Sie die Auslagerungsdatei, und führen Sie es aus.
IMAGE_FILE_SYSTEM 0x1000	Systemdatei.
IMAGE_FILE_DLL 0x2000	DLL-Datei.
IMAGE_FILE_UP_SYSTEM_ONLY 0x4000	Die Datei sollte nur auf einem Uniprozessorcomputer ausgeführt werden.
IMAGE_FILE_BYTES_REVERSED_HI 0x8000	Bytes des Worts werden umgekehrt.

ReservedCheckSum

Die Prüfsumme des Bilds.

ImageBase

Die angeforderte Basisadresse des Images.

SizeOfImage

Die Größe des Bilds in Bytes.

ReservedNumberOfSections

Die Anzahl der COFF-Abschnittsheader.

ReservedSections

Ein Zeiger auf den ersten COFF-Abschnittsheader. Weitere Informationen finden Sie unter IMAGE_SECTION_HEADER.

ReservedExportedNamesSize

Die Größe des ExportedNames-Elements in Bytes.

ReservedExportedNames

Ein Zeiger auf eine Reihe von NULL-Zeichenfolgen, die alle aus dem Image exportierten Funktionen benennen.

ReservedNumberOfFunctionTableEntries

Die Anzahl der Einträge, die im FunctionTableEntries-Element enthalten sind.

ReservedFunctionTableEntries

Ein Zeiger auf den ersten Funktionstabelleneintrag. Weitere Informationen finden Sie unter IMAGE_FUNCTION_ENTRY.

ReservedLowestFunctionStartingAddress

Die niedrigste Startadresse der Funktionstabelle.

ReservedHighestFunctionEndingAddress

Die höchste Endadresse der Funktionstabelle.

ReservedNumberOfFpoTableEntries

Die Anzahl der Einträge, die im FpoTableEntries-Element enthalten sind.

ReservedFpoTableEntries

Ein Zeiger auf den ersten FPO-Eintrag. Weitere Informationen finden Sie unter FPO_DATA.

SizeOfCoffSymbols

Die Größe der COFF-Symboltabelle in Bytes.

CoffSymbols

Ein Zeiger auf die COFF-Symboltabelle.

ReservedSizeOfCodeViewSymbols

Die Größe der CodeView-Symboltabelle in Bytes.

ReservedCodeViewSymbols

Ein Zeiger auf den Anfang der CodeView-Symboltabelle.

ImageFilePath

Der relative Pfad zum Imagedateinamen.

ImageFileName

Der Bilddateiname.

ReservedDebugFilePath

Der vollständige Pfad zur Symboldatei.

ReservedTimeDateStamp

Der Zeitstempel des Bilds. Dies stellt das Datum und die Uhrzeit dar, zu der das Image vom Linker erstellt wurde.

ReservedRomImage

Dieser Wert ist TRUE , wenn es sich bei dem Image um ein ROM-Image handelt.

ReservedDebugDirectory

Ein Zeiger auf das erste Debugverzeichnis. Weitere Informationen finden Sie unter IMAGE_DEBUG_DIRECTORY.

ReservedNumberOfDebugDirectories

Die Anzahl der Einträge, die im DebugDirectory-Member enthalten sind.

ReservedOriginalFunctionTableBaseAddress

Die ursprüngliche Funktionstabellen-Basisadresse.

Reserved[2]

Dieses Element ist für die Verwendung durch das Betriebssystem reserviert.

Hinweise

Die LIST_ENTRY-Struktur ist wie folgt definiert:

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