Condividi tramite


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
S_OK
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)

Vedi anche

.asm (Modifica opzioni di disassemblaggio)

AddAssemblyOptions

Assemblaggio

Smontare

GetAssemblyOptions

IDebugControl3

RemoveAssemblyOptions