IMAGE_DEBUG_INFORMATION structure (dbghelp.h)

Article
09/01/2022

Contains debugging information.

Note This structure is used by the MapDebugInformation and UnmapDebugInformation functions, which are provided only for backward compatibility.

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;

Members

List

A linked list of LIST_ENTRY structures.

ReservedSize

The size of the memory allocated for the IMAGE_DEBUG_INFORMATION structure and all debugging information, in bytes.

ReservedMappedBase

The base address of the image.

ReservedMachine

The computer type. This member can be one of the following values.

Value	Meaning
IMAGE_FILE_MACHINE_I386 0x014c	Intel (32-bit)
IMAGE_FILE_MACHINE_IA64 0x0200	Intel Itanium
IMAGE_FILE_MACHINE_AMD64 0x8664	x64 (AMD64 or EM64T)

ReservedCharacteristics

The characteristics of the image. This member can be one of the following values.

Value	Meaning
IMAGE_FILE_RELOCS_STRIPPED 0x0001	Relocation information is stripped from the file.
IMAGE_FILE_EXECUTABLE_IMAGE 0x0002	The file is executable (there are no unresolved external references).
IMAGE_FILE_LINE_NUMS_STRIPPED 0x0004	Line numbers are stripped from the file.
IMAGE_FILE_LOCAL_SYMS_STRIPPED 0x0008	Local symbols are stripped from file.
IMAGE_FILE_AGGRESIVE_WS_TRIM 0x0010	Aggressively trim the working set.
IMAGE_FILE_LARGE_ADDRESS_AWARE 0x0020	The application can handle addresses larger than 2 GB.
IMAGE_FILE_BYTES_REVERSED_LO 0x0080	Bytes of the word are reversed.
IMAGE_FILE_32BIT_MACHINE 0x0100	Computer supports 32-bit words.
IMAGE_FILE_DEBUG_STRIPPED 0x0200	Debugging information is stored separately in a .dbg file.
IMAGE_FILE_REMOVABLE_RUN_FROM_SWAP 0x0400	If the image is on removable media, copy and run from the swap file.
IMAGE_FILE_NET_RUN_FROM_SWAP 0x0800	If the image is on the network, copy and run from the swap file.
IMAGE_FILE_SYSTEM 0x1000	System file.
IMAGE_FILE_DLL 0x2000	DLL file.
IMAGE_FILE_UP_SYSTEM_ONLY 0x4000	File should be run only on a uniprocessor computer.
IMAGE_FILE_BYTES_REVERSED_HI 0x8000	Bytes of the word are reversed.

ReservedCheckSum

The checksum of the image.

ImageBase

The requested base address of the image.

SizeOfImage

The size of the image, in bytes.

ReservedNumberOfSections

The number of COFF section headers.

ReservedSections

A pointer to the first COFF section header. For more information, see IMAGE_SECTION_HEADER.

ReservedExportedNamesSize

The size of the ExportedNames member, in bytes.

ReservedExportedNames

A pointer to a series of null-terminated strings that name all the functions exported from the image.

ReservedNumberOfFunctionTableEntries

The number of entries contained in the FunctionTableEntries member.

ReservedFunctionTableEntries

A pointer to the first function table entry. For more information, see IMAGE_FUNCTION_ENTRY.

ReservedLowestFunctionStartingAddress

The lowest function table starting address.

ReservedHighestFunctionEndingAddress

The highest function table ending address.

ReservedNumberOfFpoTableEntries

The number of entries contained in the FpoTableEntries member.

ReservedFpoTableEntries

A pointer to the first FPO entry. For more information, see FPO_DATA.

SizeOfCoffSymbols

The size of the COFF symbol table, in bytes.

CoffSymbols

A pointer to the COFF symbol table.

ReservedSizeOfCodeViewSymbols

The size of the CodeView symbol table, in bytes.

ReservedCodeViewSymbols

A pointer to the beginning of the CodeView symbol table.

ImageFilePath

The relative path to the image file name.

ImageFileName

The image file name.

ReservedDebugFilePath

The full path to the symbol file.

ReservedTimeDateStamp

The timestamp of the image. This represents the date and time the image was created by the linker.

ReservedRomImage

This value is TRUE if the image is a ROM image.

ReservedDebugDirectory

A pointer to the first debug directory. For more information, see IMAGE_DEBUG_DIRECTORY.

ReservedNumberOfDebugDirectories

The number of entries contained in the DebugDirectory member.

ReservedOriginalFunctionTableBaseAddress

The original function table base address.

Reserved[2]

This member is reserved for use by the operating system.

Remarks

The LIST_ENTRY structure is defined as follows:

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

Requirements

Requirement	Value
Header	dbghelp.h
Redistributable	DbgHelp.dll 5.1 or later

IMAGE_DEBUG_INFORMATION structure (dbghelp.h)

Syntax

Members

Remarks

Requirements

See also

Feedback

Feedback

Additional resources