(dbgeng.h) 的 IDebugControl：：OutputDisassemblyLines 方法

發行項
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 的指令之前的行數輸出大於 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	在輸出中包含來源檔名。