Metodo IDebugControl2::D isassemble (dbgeng.h)

Articolo
02/25/2024

Il metodo Disassemble disassembla un'istruzione del processore nella memoria di 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 smontare.

[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 la visualizzerà.

[out, optional] Buffer

Riceve l'istruzione smontata. 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 smontata. Se DisassemblySize è NULL, queste informazioni non vengono restituite.

[out] EndOffset

Riceve la posizione nella memoria della destinazione dell'istruzione seguendo 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.
S_FALSE	Il metodo è stato eseguito correttamente. Tuttavia, buffer era troppo piccolo per contenere l'istruzione smontata 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 dell'assembly, vedere la documentazione del processore.

Le opzioni di 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 Assembling and Disassembling Instructions (Istruzioni di assemblaggio e smontaggio).