IDebugControl4::D isassembleWide-Methode (dbgeng.h)

Artikel
02/23/2024

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

Syntax

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

Parameter

[in] Offset

Gibt den Speicherort der zu disassemblierenden Anweisung im Speicher des Ziels an.

[in] Flags

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

[out, optional] Buffer

Empfängt die disassemblierte Anweisung. Wenn BufferNULL 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 disassemblierten Anweisung in Zeichen. Wenn DisassemblySizenull ist, werden diese Informationen nicht zurückgegeben.

[out] EndOffset

Empfängt den Speicherort im Speicher des Ziels der Anweisung, die der disassemblierten Anweisung folgt.

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 disassemblierte Anweisung zu halten, und die Anweisung wurde abgeschnitten, um sie anzupassen.

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 von 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.