IMAGE_DEBUG_INFORMATION struttura (dbghelp.h)

Articolo
02/29/2024

Contiene informazioni di debug.

Nota Questa struttura viene usata dalle funzioni MapDebugInformation e UnmapDebugInformation , disponibili solo per la compatibilità con le versioni precedenti.

Sintassi

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;

Members

List

Elenco collegato di strutture LIST_ENTRY .

ReservedSize

Dimensioni della memoria allocata per la struttura IMAGE_DEBUG_INFORMATION e tutte le informazioni di debug, in byte.

ReservedMappedBase

Indirizzo di base dell'immagine.

ReservedMachine

Tipo di computer. Questo membro può essere uno dei valori seguenti.

Valore	Significato
IMAGE_FILE_MACHINE_I386 0x014c	Intel (a 32 bit)
IMAGE_FILE_MACHINE_IA64 0x0200	Intel Itanium
IMAGE_FILE_MACHINE_AMD64 0x8664	x64 (AMD64 o EM64T)

ReservedCharacteristics

Caratteristiche dell'immagine. Questo membro può essere uno dei valori seguenti.

Valore	Significato
IMAGE_FILE_RELOCS_STRIPPED 0x0001	Le informazioni di rilocazione vengono rimosse dal file.
IMAGE_FILE_EXECUTABLE_IMAGE 0x0002	Il file è eseguibile (non sono presenti riferimenti esterni non risolti).
IMAGE_FILE_LINE_NUMS_STRIPPED 0x0004	I numeri di riga vengono rimossi dal file.
IMAGE_FILE_LOCAL_SYMS_STRIPPED 0x0008	I simboli locali vengono rimossi dal file.
IMAGE_FILE_AGGRESIVE_WS_TRIM 0x0010	Tagliare in modo aggressivo il set di lavoro.
IMAGE_FILE_LARGE_ADDRESS_AWARE 0x0020	L'applicazione può gestire indirizzi superiori a 2 GB.
IMAGE_FILE_BYTES_REVERSED_LO 0x0080	I byte della parola vengono invertito.
IMAGE_FILE_32BIT_MACHINE 0x0100	Il computer supporta parole a 32 bit.
IMAGE_FILE_DEBUG_STRIPPED 0x0200	Le informazioni di debug vengono archiviate separatamente in un file con estensione dbg.
IMAGE_FILE_REMOVABLE_RUN_FROM_SWAP 0x0400	Se l'immagine è su supporti rimovibili, copiare ed eseguire dal file di scambio.
IMAGE_FILE_NET_RUN_FROM_SWAP 0x0800	Se l'immagine si trova nella rete, copiare ed eseguire dal file di scambio.
IMAGE_FILE_SYSTEM 0x1000	File di sistema.
IMAGE_FILE_DLL 0x2000	File DLL.
IMAGE_FILE_UP_SYSTEM_ONLY 0x4000	Il file deve essere eseguito solo in un computer uniprocessore.
IMAGE_FILE_BYTES_REVERSED_HI 0x8000	I byte della parola vengono invertito.

ReservedCheckSum

Checksum dell'immagine.

ImageBase

Indirizzo di base richiesto dell'immagine.

SizeOfImage

Dimensioni dell'immagine, in byte.

ReservedNumberOfSections

Numero di intestazioni di sezione COFF.

ReservedSections

Puntatore alla prima intestazione della sezione COFF. Per altre informazioni, vedere IMAGE_SECTION_HEADER.

ReservedExportedNamesSize

Dimensione del membro ExportNames , in byte.

ReservedExportedNames

Puntatore a una serie di stringhe con terminazione null che denominano tutte le funzioni esportate dall'immagine.

ReservedNumberOfFunctionTableEntries

Numero di voci contenute nel membro FunctionTableEntries .

ReservedFunctionTableEntries

Puntatore alla prima voce della tabella di funzione. Per altre informazioni, vedere IMAGE_FUNCTION_ENTRY.

ReservedLowestFunctionStartingAddress

L'indirizzo iniziale della tabella della funzione più bassa.

ReservedHighestFunctionEndingAddress

Indirizzo finale della tabella delle funzioni più alto.

ReservedNumberOfFpoTableEntries

Numero di voci contenute nel membro FpoTableEntries .

ReservedFpoTableEntries

Puntatore alla prima voce FPO. Per altre informazioni, vedere FPO_DATA.

SizeOfCoffSymbols

Dimensioni della tabella dei simboli COFF, in byte.

CoffSymbols

Puntatore alla tabella dei simboli COFF.

ReservedSizeOfCodeViewSymbols

Dimensioni della tabella dei simboli CodeView, in byte.

ReservedCodeViewSymbols

Puntatore all'inizio della tabella dei simboli CodeView.

ImageFilePath

Percorso relativo del nome del file di immagine.

ImageFileName

Nome del file di immagine.

ReservedDebugFilePath

Percorso completo del file di simboli.

ReservedTimeDateStamp

Timestamp dell'immagine. Rappresenta la data e l'ora di creazione dell'immagine dal linker.

ReservedRomImage

Questo valore è TRUE se l'immagine è un'immagine ROM.

ReservedDebugDirectory

Puntatore alla prima directory di debug. Per altre informazioni, vedere IMAGE_DEBUG_DIRECTORY.

ReservedNumberOfDebugDirectories

Numero di voci contenute nel membro DebugDirectory .

ReservedOriginalFunctionTableBaseAddress

Indirizzo di base della tabella della funzione originale.

Reserved[2]

Questo membro è riservato per l'uso dal sistema operativo.

Commenti

La struttura LIST_ENTRY è definita come segue:

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