IDebugControl::OutputDisassembly-Methode (dbgeng.h)

Artikel
02/26/2024

Die OutputDisassembly-Methode disassembliert eine Prozessoranweisung und sendet die Disassemblierung an die Ausgaberückrufe.

Syntax

HRESULT OutputDisassembly(
  [in]  ULONG    OutputControl,
  [in]  ULONG64  Offset,
  [in]  ULONG    Flags,
  [out] PULONG64 EndOffset
);

Parameter

[in] OutputControl

Gibt das Ausgabesteuerelement an, das bestimmt, welche Ausgaberückrufe des Clients die Ausgabe empfangen. Mögliche Werte finden Sie unter DEBUG_OUTCTL_XXX. Weitere Informationen zur Ausgabe finden Sie unter Eingabe und Ausgabe.

[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. In der folgenden Tabelle sind die Bits aufgeführt, die festgelegt werden können.

Bit-Flag	Effekt beim Festlegen
DEBUG_DISASM_EFFECTIVE_ADDRESS	Berechnen Sie die effektive Adresse aus den aktuellen Registerinformationen, und zeigen Sie sie an.
DEBUG_DISASM_MATCHING_SYMBOLS	Wenn die Adresse der Anweisung eine genaue Symbol-Übereinstimmung aufweist, geben Sie das Symbol aus.
DEBUG_DISASM_SOURCE_LINE_NUMBER	Fügen Sie die Quellzeilennummer der Anweisung in die Ausgabe ein.
DEBUG_DISASM_SOURCE_FILE_NAME	Fügen Sie den Namen der Quelldatei in die Ausgabe ein.

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

Hinweise

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

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.