IDebugControl3::SetAssemblyOptions-Methode (dbgeng.h)

Artikel
02/06/2025

Die SetAssemblyOptions Methode legt die Montage- und Demontageoptionen fest, die sich darauf auswirken, wie das Debuggermodul Prozessoranweisungen für das Ziel zusammenfügt und zerlegt.

Syntax

HRESULT SetAssemblyOptions(
  [in] ULONG Options
);

Parameter

[in] Options

Gibt die neuen Assembly- und Demontageoptionen an, die vom Debuggermodulverwendet werden sollen. Optionen ist ein Bitsatz; sie ersetzt die vorhandenen Montage- und Demontageoptionen. Mögliche Werte finden Sie in den Anmerkungen. 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.

Bemerkungen

Weitere Informationen zur Verwendung der Assembly mit der Debuggermodul-API finden Sie unter Assembling and Disassembling Instructions.

Die Montage- und Demontageoptionen wirken sich darauf aus, wie das Debuggermodul Prozessoranweisungen für das Ziel zusammenfügt und zerlegt.

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

Konstante	Beschreibung
DEBUG_ASMOPT_VERBOSE	Wenn dieses Bit festgelegt ist, werden zusätzliche Informationen in der Demontage enthalten. Dies entspricht der ausführlichen Option im Befehl .asm.
DEBUG_ASMOPT_NO_CODE_BYTES	Wenn dieses Bit festgelegt ist, sind die unformatierten Bytes für eine Anweisung nicht in der Demontage enthalten. Dies entspricht der option no_code_bytes im .asm--Befehl.
DEBUG_ASMOPT_IGNORE_OUTPUT_WIDTH	Wenn dieses Bit festgelegt ist, ignoriert der Debugger die Breite der Ausgabeanzeige, wenn Formatierungsanweisungen während der Demontage formatiert werden. Dies entspricht der option ignore_output_width im befehl .asm.
DEBUG_ASMOPT_SOURCE_LINE_NUMBER	Wenn dieses Bit festgelegt ist, wird jeder Zeile der Demontageausgabe die Zeilennummer des Quellcodes vorangestellt, der von Symbolinformationen bereitgestellt wird. Dies entspricht der option source_line im .asm--Befehl.

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