estructura IMAGE_DEBUG_INFORMATION (dbghelp.h)

Artículo
08/23/2023

Contiene información de depuración.

Nota Esta estructura se usa en las funciones MapDebugInformation y UnmapDebugInformation , que solo se proporcionan para compatibilidad con versiones anteriores.

Sintaxis

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;

Miembros

List

Lista vinculada de estructuras de LIST_ENTRY .

ReservedSize

Tamaño de la memoria asignada para la estructura de IMAGE_DEBUG_INFORMATION y toda la información de depuración, en bytes.

ReservedMappedBase

Dirección base de la imagen.

ReservedMachine

Tipo de equipo. Este miembro puede ser uno de los valores siguientes.

Valor	Significado
IMAGE_FILE_MACHINE_I386 0x014c	Intel (32 bits)
IMAGE_FILE_MACHINE_IA64 0x0200	Intel Itanium
IMAGE_FILE_MACHINE_AMD64 0x8664	x64 (AMD64 o EM64T)

ReservedCharacteristics

Características de la imagen. Este miembro puede ser uno de los valores siguientes.

Valor	Significado
IMAGE_FILE_RELOCS_STRIPPED 0x0001	La información de reubicación se quita del archivo.
IMAGE_FILE_EXECUTABLE_IMAGE 0x0002	El archivo es ejecutable (no hay referencias externas sin resolver).
IMAGE_FILE_LINE_NUMS_STRIPPED 0x0004	Los números de línea se quitan del archivo.
IMAGE_FILE_LOCAL_SYMS_STRIPPED 0x0008	Los símbolos locales se quitan del archivo.
IMAGE_FILE_AGGRESIVE_WS_TRIM 0x0010	Recorte agresivamente el espacio de trabajo.
IMAGE_FILE_LARGE_ADDRESS_AWARE 0x0020	La aplicación puede controlar direcciones de más de 2 GB.
IMAGE_FILE_BYTES_REVERSED_LO 0x0080	Se invierten los bytes de la palabra.
IMAGE_FILE_32BIT_MACHINE 0x0100	El equipo admite palabras de 32 bits.
IMAGE_FILE_DEBUG_STRIPPED 0x0200	La información de depuración se almacena por separado en un archivo .dbg.
IMAGE_FILE_REMOVABLE_RUN_FROM_SWAP 0x0400	Si la imagen está en medios extraíbles, copie y ejecute desde el archivo de intercambio.
IMAGE_FILE_NET_RUN_FROM_SWAP 0x0800	Si la imagen está en la red, copie y ejecute desde el archivo de intercambio.
IMAGE_FILE_SYSTEM 0x1000	Archivo de sistema.
IMAGE_FILE_DLL 0x2000	Archivo DLL.
IMAGE_FILE_UP_SYSTEM_ONLY 0x4000	El archivo solo se debe ejecutar en un equipo uniprocesador.
IMAGE_FILE_BYTES_REVERSED_HI 0x8000	Se invierten los bytes de la palabra.

ReservedCheckSum

Suma de comprobación de la imagen.

ImageBase

Dirección base solicitada de la imagen.

SizeOfImage

Tamaño de la imagen, en bytes.

ReservedNumberOfSections

Número de encabezados de sección COFF.

ReservedSections

Puntero al primer encabezado de sección COFF. Para obtener más información, consulte IMAGE_SECTION_HEADER.

ReservedExportedNamesSize

Tamaño del miembro ExportedNames , en bytes.

ReservedExportedNames

Puntero a una serie de cadenas terminadas en NULL que asignan un nombre a todas las funciones exportadas desde la imagen.

ReservedNumberOfFunctionTableEntries

Número de entradas contenidas en el miembro FunctionTableEntries .

ReservedFunctionTableEntries

Puntero a la primera entrada de la tabla de funciones. Para obtener más información, consulte IMAGE_FUNCTION_ENTRY.

ReservedLowestFunctionStartingAddress

Dirección inicial de la tabla de funciones más baja.

ReservedHighestFunctionEndingAddress

Dirección final de la tabla de funciones más alta.

ReservedNumberOfFpoTableEntries

Número de entradas contenidas en el miembro FpoTableEntries .

ReservedFpoTableEntries

Puntero a la primera entrada de FPO. Para obtener más información, consulte FPO_DATA.

SizeOfCoffSymbols

Tamaño de la tabla de símbolos COFF, en bytes.

CoffSymbols

Puntero a la tabla de símbolos COFF.

ReservedSizeOfCodeViewSymbols

Tamaño de la tabla de símbolos de CodeView, en bytes.

ReservedCodeViewSymbols

Puntero al principio de la tabla de símbolos de CodeView.

ImageFilePath

Ruta de acceso relativa al nombre del archivo de imagen.

ImageFileName

Nombre del archivo de imagen.

ReservedDebugFilePath

Ruta de acceso completa al archivo de símbolos.

ReservedTimeDateStamp

Marca de tiempo de la imagen. Esto representa la fecha y hora en que el enlazador creó la imagen.

ReservedRomImage

Este valor es TRUE si la imagen es una imagen ROM.

ReservedDebugDirectory

Puntero al primer directorio de depuración. Para obtener más información, consulte IMAGE_DEBUG_DIRECTORY.

ReservedNumberOfDebugDirectories

Número de entradas contenidas en el miembro DebugDirectory .

ReservedOriginalFunctionTableBaseAddress

Dirección base de la tabla de funciones original.

Reserved[2]

Este miembro está reservado para que lo use el sistema operativo.

Comentarios

La estructura LIST_ENTRY se define de la siguiente manera:

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