IDebugControl3::OutputDisassemblyLines メソッド (dbgeng.h)

[アーティクル]
02/23/2024

OutputDisassemblyLines メソッドは、いくつかのプロセッサ命令を逆アセンブルし、結果のアセンブリ命令を出力コールバックに送信します。

構文

HRESULT OutputDisassemblyLines(
  [in]            ULONG    OutputControl,
  [in]            ULONG    PreviousLines,
  [in]            ULONG    TotalLines,
  [in]            ULONG64  Offset,
  [in]            ULONG    Flags,
  [out, optional] PULONG   OffsetLine,
  [out, optional] PULONG64 StartOffset,
  [out, optional] PULONG64 EndOffset,
  [out, optional] PULONG64 LineOffsets
);

パラメーター

[in] OutputControl

出力を受信するクライアントの出力コールバックを決定する出力コントロールを指定します。使用可能な値については、「 DEBUG_OUTCTL_XXX」を参照してください。出力の詳細については、「入力と出力」を参照してください。

[in] PreviousLines

出力に含める Offset の命令の前の命令行数を指定します。通常、各命令は 1 行で出力されます。ただし、一部の命令では複数行の出力が必要な場合があります。これにより、 Offset の命令の前に出力される行数が PreviousLines より大きくなる可能性があります。

[in] TotalLines

出力に含める命令行の合計数を指定します。通常、各命令は 1 行で出力されます。ただし、一部の命令では複数行の出力が必要な場合があります。これにより、出力される行数が TotalLines を超える可能性があります。

[in] Offset

逆アセンブリする命令のターゲットのメモリ内の場所を指定します。逆アセンブリ出力は、これらのプロセッサ命令の前に PreviousLines 行を開始します。

[in] Flags

このメソッドの動作に影響するビットフラグを指定します。次の表に、設定できるビットの一覧を示します。

Bit-Flag	設定時の効果
DEBUG_DISASM_EFFECTIVE_ADDRESS	現在のレジスタ情報から各命令の有効アドレスを計算し、出力します。
DEBUG_DISASM_MATCHING_SYMBOLS	命令のアドレスに完全に一致するシンボルがある場合は、シンボルを出力します。
DEBUG_DISASM_SOURCE_LINE_NUMBER	出力に各命令のソース行番号を含めます。
DEBUG_DISASM_SOURCE_FILE_NAME	出力にソースファイル名を含めます。