IMAGE_DEBUG_INFORMATION 構造体 (dbghelp.h)

[アーティクル]
08/23/2023

デバッグ情報を格納します。

メモこの構造体は、下位互換性のためにのみ提供される 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 GB を超えるアドレスを処理できます。
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

イメージが ROM イメージの場合、この値は 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;