Metodo IDebugControl3::D isassemble (dbgeng.h)

Articolo
02/26/2024

Il metodo Disassemble disassembla un'istruzione del processore nella memoria della destinazione.

Sintassi

HRESULT Disassemble(
  [in]            ULONG64  Offset,
  [in]            ULONG    Flags,
  [out, optional] PSTR     Buffer,
  [in]            ULONG    BufferSize,
  [out, optional] PULONG   DisassemblySize,
  [out]           PULONG64 EndOffset
);

Parametri

[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. Attualmente l'unico flag che può essere impostato è DEBUG_DISASM_EFFECTIVE_ADDRESS; se impostato, il motore calcola l'indirizzo effettivo dalle informazioni del registro corrente e lo visualizza.

[out, optional] Buffer

Riceve l'istruzione disassemblata. Se Buffer è NULL, queste informazioni non vengono restituite.

[in] BufferSize

Specifica le dimensioni, in caratteri, del buffer buffer .

[out, optional] DisassemblySize

Riceve le dimensioni, in caratteri, dell'istruzione disassemblata. Se DisassemblySize è NULL, queste informazioni non vengono restituite.

[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.
S_FALSE	Il metodo è stato eseguito correttamente. Buffer era tuttavia troppo piccolo per contenere l'istruzione disassemblata e l'istruzione è stata troncata per adattarsi.

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.

Le opzioni disassembly restituite da GetAssemblyOptions influiscono sull'operazione di questo metodo.

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.