Metodo IDebugControl3::SetAssemblyOptions (dbgeng.h)

Articolo
02/06/2025

Il metodo SetAssemblyOptions imposta le opzioni di assembly e disassembly che influiscono sul modo in cui il motore del debugger assembla e disassembla le istruzioni del processore per la destinazione.

Sintassi

HRESULT SetAssemblyOptions(
  [in] ULONG Options
);

Parametri

[in] Options

Specifica le nuove opzioni di assembly e disassembly da utilizzare dal motore del debugger . Opzioni è un set di bit; sostituirà le opzioni di assembly e disassembly esistenti. Per i valori possibili, vedere Osservazioni. DEBUG_ASMOPT_DEFAULT possibile usare per impostare le opzioni predefinite.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altri dettagli, vedere valori restituiti.

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.

Osservazioni

Per altre informazioni sull'uso dell'assembly con l'API del motore di debugger, vedere Assembling and Disassembling Instructions.

Le opzioni di assembly e disassembly influiscono sul modo in cui il motore del debugger assembla e disassembla le istruzioni del processore per la destinazione.

Le opzioni sono rappresentate da un bitset con i flag di bit seguenti.

Costante	Descrizione
DEBUG_ASMOPT_VERBOSE	Quando questo bit è impostato, le informazioni aggiuntive vengono incluse nel disassembly. Equivale all'opzione dettagliata nel comando .asm.
DEBUG_ASMOPT_NO_CODE_BYTES	Quando questo bit è impostato, i byte non elaborati per un'istruzione non vengono inclusi nel disassembly. Equivale all'opzione no_code_bytes nel comando .asm.
DEBUG_ASMOPT_IGNORE_OUTPUT_WIDTH	Quando questo bit è impostato, il debugger ignora la larghezza della visualizzazione dell'output durante la formattazione delle istruzioni durante il disassembly. Equivale all'opzione ignore_output_width nel comando .asm.
DEBUG_ASMOPT_SOURCE_LINE_NUMBER	Quando questo bit viene impostato, ogni riga dell'output disassembly è preceduta dal numero di riga del codice sorgente fornito dalle informazioni sul simbolo. Equivale all'opzione source_line nel comando .asm.

Inoltre, il valore DEBUG_ASMOPT_DEFAULT rappresenta il set predefinito di opzioni di assembly e disassembly. Ciò significa che tutte le opzioni della tabella precedente vengono disattivate.