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

Artikel
02/26/2024

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.