Metodo IDebugControl::OutputDisassembly (dbgeng.h)

Articolo
02/23/2024

Il metodo OutputDisassembly disassembla un'istruzione del processore e invia il disassembly ai callback di output.

Sintassi

HRESULT OutputDisassembly(
  [in]  ULONG    OutputControl,
  [in]  ULONG64  Offset,
  [in]  ULONG    Flags,
  [out] PULONG64 EndOffset
);

Parametri

[in] OutputControl

Specifica il controllo di output che determina i callback di output del client che ricevono l'output. Per i valori possibili, vedere DEBUG_OUTCTL_XXX. Per altre informazioni sull'output, vedere Input e Output.

[in] Offset

Specifica la posizione nella memoria della destinazione dell'istruzione da smontare.

[in] Flags

Specifica i flag di bit che influiscono sul comportamento di questo metodo. Nella tabella seguente sono elencati i bit che possono essere impostati.

Bit-Flag	Effetto quando impostato
DEBUG_DISASM_EFFECTIVE_ADDRESS	Calcolare l'indirizzo effettivo dalle informazioni correnti del registro e visualizzarlo.
DEBUG_DISASM_MATCHING_SYMBOLS	Se l'indirizzo dell'istruzione ha una corrispondenza esatta dei simboli, restituire il simbolo.
DEBUG_DISASM_SOURCE_LINE_NUMBER	Includere il numero di riga di origine dell'istruzione nell'output.
DEBUG_DISASM_SOURCE_FILE_NAME	Includere il nome del file di origine nell'output.

[out] EndOffset

Riceve la posizione nella memoria della destinazione dell'istruzione che segue l'istruzione smontata.

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

Il linguaggio dell'assembly dipende dal tipo di processore effettivo del sistema di destinazione. Per informazioni sul linguaggio dell'assembly, vedere la documentazione del processore.

Per una panoramica dell'uso dell'assembly nelle applicazioni debugger, vedere Debug in modalità assembly. Per altre informazioni sull'uso dell'assembly con l'API del motore di debugger, vedere Assembling and Disassembling Instructions (Istruzioni di assemblaggio e smontaggio).