Поделиться через

структура IMAGE_DEBUG_INFORMATION (dbghelp.h)

  • Статья

Содержит отладочную информацию.

Примечание Эта структура используется функциями MapDebugInformation и UnmapDebugInformation , которые предоставляются только для обеспечения обратной совместимости.
 

Синтаксис

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;

Члены

List

Связанный список LIST_ENTRY структур.

ReservedSize

Размер памяти, выделенной для структуры IMAGE_DEBUG_INFORMATION и всей отладочную информацию, в байтах.

ReservedMappedBase

Базовый адрес образа.

ReservedMachine

Тип компьютера. Этот элемент может иметь одно из следующих значений.

Значение Значение
IMAGE_FILE_MACHINE_I386
0x014c
 Intel (32-разрядная версия)
IMAGE_FILE_MACHINE_IA64
0x0200
 Intel Itanium
IMAGE_FILE_MACHINE_AMD64
0x8664
 x64 (AMD64 или EM64T)

ReservedCharacteristics

Характеристики изображения. Этот элемент может иметь одно из следующих значений.

Значение Значение
IMAGE_FILE_RELOCS_STRIPPED
0x0001
 Сведения о перемещении удаляются из файла.
IMAGE_FILE_EXECUTABLE_IMAGE
0x0002
 Файл является исполняемым (нет неразрешенных внешних ссылок).
IMAGE_FILE_LINE_NUMS_STRIPPED
0x0004
 Номера строк удаляются из файла.
IMAGE_FILE_LOCAL_SYMS_STRIPPED
0x0008
 Локальные символы удаляются из файла.
IMAGE_FILE_AGGRESIVE_WS_TRIM
0x0010
 Агрессивно обрезать рабочий набор.
IMAGE_FILE_LARGE_ADDRESS_AWARE
0x0020
 Приложение может обрабатывать адреса размером более 2 ГБ.
IMAGE_FILE_BYTES_REVERSED_LO
0x0080
 Байты слова являются обратными.
IMAGE_FILE_32BIT_MACHINE
0x0100
 Компьютер поддерживает 32-разрядные слова.
IMAGE_FILE_DEBUG_STRIPPED
0x0200
 Сведения об отладке хранятся отдельно в DBG-файле.
IMAGE_FILE_REMOVABLE_RUN_FROM_SWAP
0x0400
 Если образ находится на съемном носителе, скопируйте и запустите его из файла подкачки.
IMAGE_FILE_NET_RUN_FROM_SWAP
0x0800
 Если образ находится в сети, скопируйте и запустите его из файла подкачки.
IMAGE_FILE_SYSTEM
0x1000
 Системный файл.
IMAGE_FILE_DLL
0x2000
 DLL-файл.
IMAGE_FILE_UP_SYSTEM_ONLY
0x4000
 Файл должен выполняться только на однопроцессорном компьютере.
IMAGE_FILE_BYTES_REVERSED_HI
0x8000
 Байты слова являются обратными.

ReservedCheckSum

Контрольная сумма изображения.

ImageBase

Запрошенный базовый адрес образа.

SizeOfImage

Размер изображения в байтах.

ReservedNumberOfSections

Количество заголовков разделов COFF.

ReservedSections

Указатель на первый заголовок раздела COFF. Дополнительные сведения см. в разделе IMAGE_SECTION_HEADER.

ReservedExportedNamesSize

Размер элемента ExportedNames в байтах .

ReservedExportedNames

Указатель на последовательность строк, заканчивающихся значением NULL, которые называют все функции, экспортированные из изображения.

ReservedNumberOfFunctionTableEntries

Количество записей, содержащихся в элементе FunctionTableEntries .

ReservedFunctionTableEntries

Указатель на первую запись таблицы функций. Дополнительные сведения см. в разделе IMAGE_FUNCTION_ENTRY.

ReservedLowestFunctionStartingAddress

Наименьший начальный адрес таблицы функций.

ReservedHighestFunctionEndingAddress

Самый высокий конечный адрес таблицы функций.

ReservedNumberOfFpoTableEntries

Количество записей, содержащихся в элементе FpoTableEntries .

ReservedFpoTableEntries

Указатель на первую запись FPO. Дополнительные сведения см. в разделе FPO_DATA.

SizeOfCoffSymbols

Размер таблицы символов COFF в байтах.

CoffSymbols

Указатель на таблицу символов COFF.

ReservedSizeOfCodeViewSymbols

Размер таблицы символов CodeView в байтах.

ReservedCodeViewSymbols

Указатель на начало таблицы символов CodeView.

ImageFilePath

Относительный путь к имени файла изображения.

ImageFileName

Имя файла изображения.

ReservedDebugFilePath

Полный путь к файлу символов.

ReservedTimeDateStamp

Метка времени изображения. Представляет дату и время создания образа компоновщиком.

ReservedRomImage

Это значение равно TRUE , если образ является образом ПЗУ.

ReservedDebugDirectory

Указатель на первый каталог отладки. Дополнительные сведения см. в разделе IMAGE_DEBUG_DIRECTORY.

ReservedNumberOfDebugDirectories

Количество записей, содержащихся в элементе DebugDirectory .

ReservedOriginalFunctionTableBaseAddress

Исходный базовый адрес таблицы функций.

Reserved[2]

Этот элемент зарезервирован для использования операционной системой.

Комментарии

Структура LIST_ENTRY определяется следующим образом:

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

Требования

Требование Значение
Заголовок dbghelp.h
Распространяемые компоненты DbgHelp.dll 5.1 или более поздней версии

См. также раздел

FPO_DATA

IMAGE_COFF_SYMBOLS_HEADER

IMAGE_DEBUG_DIRECTORY

IMAGE_FUNCTION_ENTRY

IMAGE_SECTION_HEADER

MapDebugInformation

UnmapDebugInformation