estrutura IMAGE_DEBUG_INFORMATION (dbghelp.h)

Artigo
08/23/2023

Contém informações de depuração.

Nota Essa estrutura é usada pelas funções MapDebugInformation e UnmapDebugInformation , que são fornecidas apenas para compatibilidade com versões anteriores.

Sintaxe

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;

Membros

List

Uma lista vinculada de estruturas de LIST_ENTRY .

ReservedSize

O tamanho da memória alocada para a estrutura IMAGE_DEBUG_INFORMATION e todas as informações de depuração, em bytes.

ReservedMappedBase

O endereço base da imagem.

ReservedMachine

O tipo de computador. Esse membro pode ser um dos valores a seguir.

Valor	Significado
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

As características da imagem. Esse membro pode ser um dos valores a seguir.

Valor	Significado
IMAGE_FILE_RELOCS_STRIPPED 0x0001	As informações de realocação são removidas do arquivo.
IMAGE_FILE_EXECUTABLE_IMAGE 0x0002	O arquivo é executável (não há referências externas não resolvidas).
IMAGE_FILE_LINE_NUMS_STRIPPED 0x0004	Os números de linha são removidos do arquivo.
IMAGE_FILE_LOCAL_SYMS_STRIPPED 0x0008	Os símbolos locais são removidos do arquivo.
IMAGE_FILE_AGGRESIVE_WS_TRIM 0x0010	Corte agressivamente o conjunto de trabalho.
IMAGE_FILE_LARGE_ADDRESS_AWARE 0x0020	O aplicativo pode lidar com endereços maiores que 2 GB.
IMAGE_FILE_BYTES_REVERSED_LO 0x0080	Bytes da palavra são invertidos.
IMAGE_FILE_32BIT_MACHINE 0x0100	O computador dá suporte a palavras de 32 bits.
IMAGE_FILE_DEBUG_STRIPPED 0x0200	As informações de depuração são armazenadas separadamente em um arquivo .dbg.
IMAGE_FILE_REMOVABLE_RUN_FROM_SWAP 0x0400	Se a imagem estiver na mídia removível, copie e execute no arquivo de troca.
IMAGE_FILE_NET_RUN_FROM_SWAP 0x0800	Se a imagem estiver na rede, copie e execute no arquivo de troca.
IMAGE_FILE_SYSTEM 0x1000	Arquivo do sistema.
IMAGE_FILE_DLL 0x2000	Arquivo DLL.
IMAGE_FILE_UP_SYSTEM_ONLY 0x4000	O arquivo deve ser executado somente em um computador uniprocessador.
IMAGE_FILE_BYTES_REVERSED_HI 0x8000	Bytes da palavra são invertidos.

ReservedCheckSum

A soma de verificação da imagem.

ImageBase

O endereço base solicitado da imagem.

SizeOfImage

O tamanho da imagem, em bytes.

ReservedNumberOfSections

O número de cabeçalhos de seção COFF.

ReservedSections

Um ponteiro para o primeiro cabeçalho da seção COFF. Para obter mais informações, consulte IMAGE_SECTION_HEADER.

ReservedExportedNamesSize

O tamanho do membro ExportedNames , em bytes.

ReservedExportedNames

Um ponteiro para uma série de cadeias de caracteres terminadas em nulo que nomeia todas as funções exportadas da imagem.

ReservedNumberOfFunctionTableEntries

O número de entradas contidas no membro FunctionTableEntries .

ReservedFunctionTableEntries

Um ponteiro para a primeira entrada da tabela de funções. Para obter mais informações, consulte IMAGE_FUNCTION_ENTRY.

ReservedLowestFunctionStartingAddress

O endereço inicial da tabela de funções mais baixa.

ReservedHighestFunctionEndingAddress

O endereço final da tabela de funções mais alta.

ReservedNumberOfFpoTableEntries

O número de entradas contidas no membro FpoTableEntries .

ReservedFpoTableEntries

Um ponteiro para a primeira entrada FPO. Para obter mais informações, consulte FPO_DATA.

SizeOfCoffSymbols

O tamanho da tabela de símbolos COFF, em bytes.

CoffSymbols

Um ponteiro para a tabela de símbolos COFF.

ReservedSizeOfCodeViewSymbols

O tamanho da tabela de símbolos CodeView, em bytes.

ReservedCodeViewSymbols

Um ponteiro para o início da tabela de símbolos CodeView.

ImageFilePath

O caminho relativo para o nome do arquivo de imagem.

ImageFileName

O nome do arquivo de imagem.

ReservedDebugFilePath

O caminho completo para o arquivo de símbolo.

ReservedTimeDateStamp

O carimbo de data/hora da imagem. Isso representa a data e a hora em que a imagem foi criada pelo vinculador.

ReservedRomImage

Esse valor será TRUE se a imagem for uma imagem ROM.

ReservedDebugDirectory

Um ponteiro para o primeiro diretório de depuração. Para obter mais informações, consulte IMAGE_DEBUG_DIRECTORY.

ReservedNumberOfDebugDirectories

O número de entradas contidas no membro DebugDirectory .

ReservedOriginalFunctionTableBaseAddress

O endereço base da tabela de funções original.

Reserved[2]

Esse membro é reservado para uso pelo sistema operacional.

Comentários

A estrutura LIST_ENTRY é definida da seguinte maneira:

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