Freigeben über


IDebugControl::D isassemble-Methode (dbgeng.h)

Die Disassemble-Methode disassembliert eine Prozessoranweisung im Speicher des Ziels.

Syntax

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

Parameter

[in] Offset

Gibt den Speicherort der Anweisung zum Disassemblieren im Speicher des Ziels an.

[in] Flags

Gibt die Bitflags an, die das Verhalten dieser Methode beeinflussen. Das einzige Flag, das festgelegt werden kann, ist derzeit DEBUG_DISASM_EFFECTIVE_ADDRESS; wenn festgelegt, berechnet das Modul die effektive Adresse aus den aktuellen Registerinformationen und zeigt sie an.

[out, optional] Buffer

Empfängt die zerlegte Anweisung. Wenn PufferNULL ist, werden diese Informationen nicht zurückgegeben.

[in] BufferSize

Gibt die Größe des Pufferpuffers in Zeichen an.

[out, optional] DisassemblySize

Empfängt die Größe der zerlegten Anweisung in Zeichen. Wenn DisassemblySizeNULL ist, werden diese Informationen nicht zurückgegeben.

[out] EndOffset

Empfängt den Speicherort im Speicher des Ziels der Anweisung nach der disassemblierten Anweisung.

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode BESCHREIBUNG
S_OK
Die Methode war erfolgreich.
S_FALSE
Die Methode war erfolgreich. Puffer war jedoch zu klein, um die zerlegte Anweisung aufzunehmen, und die Anweisung wurde so abgeschnitten, dass sie passte.

Hinweise

Die Assemblysprache hängt vom effektiven Prozessortyp des Zielsystems ab. Informationen zur Assemblysprache finden Sie in der Prozessordokumentation.

Die Von GetAssemblyOptions zurückgegebenen Disassemblierungsoptionen wirken sich auf den Vorgang dieser Methode aus.

Eine Übersicht über die Verwendung der Assembly in Debuggeranwendungen finden Sie unter Debuggen im Assemblymodus. Weitere Informationen zur Verwendung der Assembly mit der Debugger-Engine-API finden Sie unter Anweisungen zum Zusammenbauen und Disassemblieren.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile dbgeng.h (einschließlich Dbgeng.h)

Weitere Informationen

Assemble

GetAssemblyOptions

IDebugControl

IDebugControl2

IDebugControl3

u (Unassemble)