(dbgeng.h) IDebugControl::D isassemble 方法

反組譯方法會反組譯目標記憶體中的處理器指令。

語法

HRESULT Disassemble(
  [in]            ULONG64  Offset,
  [in]            ULONG    Flags,
  [out, optional] PSTR     Buffer,
  [in]            ULONG    BufferSize,
  [out, optional] PULONG   DisassemblySize,
  [out]           PULONG64 EndOffset
);

參數

[in] Offset

指定要反組譯之指令之目標記憶體中的位置。

[in] Flags

指定影響這個方法行為的位旗標。 目前唯一可設定的旗標是DEBUG_DISASM_EFFECTIVE_ADDRESS;設定時,引擎會計算目前緩存器資訊的有效位址,並加以顯示。

[out, optional] Buffer

接收反組譯的指令。 如果 BufferNULL,則不會傳回此資訊。

[in] BufferSize

指定 緩衝區 緩衝區的大小,以字元為單位。

[out, optional] DisassemblySize

接收反組譯指令的大小,以字元為單位。 如果 DisassemblySizeNULL,則不會傳回此資訊。

[out] EndOffset

依照反組譯的指示,接收目標記憶體中的位置。

傳回值

這個方法也可以傳回錯誤值。 如需詳細資訊,請參閱 傳回值

傳回碼 描述
S_OK
此方法成功。
S_FALSE
此方法成功。 不過, Buffer 太小而無法保存反組譯的指令,而且已截斷指令以符合。

備註

元件語言取決於目標系統的有效處理器類型。 如需元件語言的相關信息,請參閱處理器檔。

GetAssemblyOptions 傳回的反組譯碼選項會影響此方法的作業。

如需在調試程式應用程式中使用元件的概觀,請參閱 在元件模式中偵錯。 如需搭配調試程式引擎 API 使用元件的詳細資訊,請參閱 組合和反組譯指示

規格需求

需求
目標平台 桌面
標頭 dbgeng.h (包含 Dbgeng.h)

另請參閱

Assemble

GetAssemblyOptions

IDebugControl

IDebugControl2

IDebugControl3

u (Unassemble)