/DEBUGTYPE (デバッグ情報オプション)

/DEBUGTYPE オプションは、/DEBUG オプションによって生成されるデバッグ情報の種類を指定します。

/DEBUGTYPE:[CV | PDATA | FIXUP]

引数

品種
シンボル、行番号、その他のオブジェクトのコンパイル情報のデバッグ情報を PDB ファイルに出力するようにリンカーに指示します。 既定では、/DEBUG が指定されていて /DEBUGTYPE が指定されていないときにこのオプションが有効になります。

PDATA
.pdata エントリと .xdata エントリを PDB ファイル内のデバッグ ストリーム情報に追加するようにリンカーに指示します。 既定では、/DEBUG オプションと /DRIVER オプションの両方が指定されているときにこのオプションが有効になります。 /DEBUGTYPE:PDATA だけが指定されている場合、リンカーは自動的にデバッグ シンボルを PDB ファイルに含めます。 /DEBUGTYPE:PDATA,FIXUP が指定されている場合、リンカーはデバッグ シンボルを PDB ファイルに含めません。

FIXUP
再配置テーブル エントリを PDB ファイル内のデバッグ ストリーム情報に追加するようにリンカーに指示します。 既定では、/DEBUG オプションと /PROFILE オプションの両方が指定されているときにこのオプションが有効になります。 /DEBUGTYPE:FIXUP または /DEBUGTYPE:FIXUP,PDATA が指定されている場合、リンカーはデバッグ シンボルを PDB ファイルに含めません。

/DEBUGTYPE の引数は、コンマで区切って任意の順序で組み合わせることができます。 /DEBUGTYPE オプションとその引数では、大文字と小文字は区別されません。

解説

/DEBUGTYPE オプションを使用して、再配置テーブル データまたは .pdata および .xdata ヘッダー情報をデバッグ ストリームに含めることを指定します。 これにより、リンカーは、カーネルモード コードで中断するときにカーネル デバッガーに表示されるユーザーモード コードに関する情報を含めます。 FIXUP が指定されたときにデバッグ シンボルを使用できるようにするには、CV 引数を含めます。

(アプリケーションで一般的に使用される) ユーザー モードのコードをデバッグする場合は、/DEBUGTYPE オプションは必要ありません。 既定では、デバッグの出力を指定するコンパイラ スイッチ (/Z7、/Zi、/ZI) によって、Visual Studio デバッガーで必要なすべての情報が出力されます。 ユーザーモード コンポーネントとカーネルモード コンポーネントを組み合わせたコード (デバイス ドライバーの構成アプリなど) をデバッグするには、/DEBUGTYPE:PDATA または /DEBUGTYPE:CV,PDATA,FIXUP を使用します。 カーネル モード デバッガーの詳細については、「Windows 用デバッグ ツール (WinDbg、KD、CDB、NTSD)」を参照してください

関連項目

/DEBUG (デバッグ情報の生成)
/DRIVER (Windows NT カーネル モード ドライバー)
/PROFILE (パフォーマンス ツール プロファイラー)
Debugging Tools for Windows (WinDbg、KD、CDB、NTSD)