Metodo IDebugControl2::OutputDisassembly (dbgeng.h)

Articolo
08/07/2023

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 quali callback di output del client 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 disassemblare.

[in] Flags

Specifica i flag di bit che influiscono sul comportamento di questo metodo. Nella tabella seguente sono elencati i bit che è possibile impostare.

Bit-Flag	Effetto quando impostato
DEBUG_DISASM_EFFECTIVE_ADDRESS	Calcolare l'indirizzo effettivo dalle informazioni del registro corrente e visualizzarlo.
DEBUG_DISASM_MATCHING_SYMBOLS	Se l'indirizzo dell'istruzione ha una corrispondenza esatta del simbolo, 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 disassemblata.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altri dettagli, 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 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 Istruzioni per l'assemblaggio e il disassembling.