Metodo IDebugControl3::SetAssemblyOptions (dbgeng.h)
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 usare dal motore del debugger. Le opzioni sono un set di bit; sostituirà le opzioni di assembly e disassembly esistenti. Per i valori possibili, vedere Osservazioni. DEBUG_ASMOPT_DEFAULT può essere usato per impostare le opzioni predefinite.
Valore restituito
Questo metodo può anche restituire valori di errore. Per altre informazioni, vedere Valori restituiti .
Codice restituito | Descrizione |
---|---|
|
Il metodo è stato eseguito correttamente. |
Commenti
Per altre informazioni sull'uso dell'assembly con l'API del motore di debugger, vedere Assembling and Disassembling Instructions (Istruzioni di assemblaggio e smontaggio).
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 sono 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 viene 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.
Requisiti
Requisito | Valore |
---|---|
Piattaforma di destinazione | Desktop |
Intestazione | dbgeng.h (includere Dbgeng.h) |