IDebugControl3::SetAssemblyOptions-Methode (dbgeng.h)

Artikel
02/23/2024

Die SetAssemblyOptions-Methode legt die Assembly- und Disassemblierungsoptionen fest, die sich darauf auswirken, wie die Debugger-Engine Prozessoranweisungen für das Ziel zusammenfügt und zerlegt.

Syntax

HRESULT SetAssemblyOptions(
  [in] ULONG Options
);

Parameter

[in] Options

Gibt die neuen Assembly- und Disassemblierungsoptionen an, die vom Debuggermodul verwendet werden sollen. Optionen ist ein Bitsatz. Sie ersetzt die vorhandenen Assembly- und Disassemblierungsoptionen. Mögliche Werte finden Sie unter Hinweise. DEBUG_ASMOPT_DEFAULT können verwendet werden, um die Standardoptionen festzulegen.

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

Weitere Informationen zur Verwendung der Assembly mit der Debugger-Engine-API finden Sie unter Anweisungen zum Zusammenbauen und Disassemblieren.

Die Assembly- und Disassembly-Optionen wirken sich darauf aus, wie die Debugger-Engine Prozessoranweisungen für das Ziel zusammenfügt und zerlegt.

Die Optionen werden durch ein Bitset mit den folgenden Bitflags dargestellt.

Dauerhaft	BESCHREIBUNG
DEBUG_ASMOPT_VERBOSE	Wenn dieses Bit festgelegt ist, sind zusätzliche Informationen in der Disassemblierung enthalten. Dies entspricht der ausführlichen Option im Asm-Befehl .
DEBUG_ASMOPT_NO_CODE_BYTES	Wenn dieses Bit festgelegt ist, werden die unformatierten Bytes für eine Anweisung nicht in die Disassemblierung einbezogen. Dies entspricht der Option no_code_bytes im Befehl .asm .
DEBUG_ASMOPT_IGNORE_OUTPUT_WIDTH	Wenn dieses Bit festgelegt ist, ignoriert der Debugger die Breite der Ausgabeanzeige beim Formatieren von Anweisungen während der Demontage. Dies entspricht der Option ignore_output_width im Befehl .asm .
DEBUG_ASMOPT_SOURCE_LINE_NUMBER	Wenn dieses Bit festgelegt wird, wird jeder Zeile der Disassemblierungsausgabe die Zeilennummer des Quellcodes durch Symbolinformationen vorangestellt. Dies entspricht der Option source_line im Asm-Befehl .

Darüber hinaus stellt der Wert DEBUG_ASMOPT_DEFAULT den Standardsatz von Assembly- und Disassembly-Optionen dar. Dies bedeutet, dass alle Optionen in der vorherigen Tabelle deaktiviert sind.