IDebugControl3：：OutputDisassemblyLines 方法 (dbgeng.h)

项目
08/07/2023

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 处的指令之前要包含在输出中的指令行数。通常，每个指令在单行上输出。但是，某些指令可能会占用多行输出;这可能会导致 在 Offset 处的指令之前输出的行数大于 PreviousLines。

[in] TotalLines

指定要包含在输出中的指令行总数。通常，每个指令在单行上输出。但是，某些指令可能会占用多行输出;这可能会导致输出的行数大于 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	在输出中包含源文件名称。