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

Artikel
02/06/2025

Die Disassemblierung Methode zerlegt 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 die Position im Speicher des Ziels der zu zerlegenden Anweisung an.Specifies the location in the target's memory of the instruction to disassemble.

[in] Flags

Gibt die Bit-Flags an, die sich auf das Verhalten dieser Methode auswirken. Derzeit ist die einzige Kennzeichnung, die festgelegt werden kann, 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 Puffer-NULL-ist, werden diese Informationen nicht zurückgegeben.

[in] BufferSize

Gibt die Größe des Puffer- Puffers 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 die Position im Speicher des Ziels der Anweisung nach der zerlegten 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. Buffer war jedoch zu klein, um die zerlegte Anweisung zu halten, und die Anweisung wurde abgeschnitten.

Bemerkungen

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

Die von GetAssemblyOptionszurückgegebenen Demontageoptionen 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 Debuggermodul-API finden Sie unter Assembling and Disassembling Instructions.