IDebugControl ::D isassemble, méthode (dbgeng.h)

Article
08/07/2023

La méthode Désassemble une instruction de processeur dans la mémoire de la cible.

Syntaxe

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

Paramètres

[in] Offset

Spécifie l’emplacement dans la mémoire de la cible de l’instruction à désassembler.

[in] Flags

Spécifie les indicateurs de bits qui affectent le comportement de cette méthode. Actuellement, le seul indicateur qui peut être défini est DEBUG_DISASM_EFFECTIVE_ADDRESS ; quand il est défini, le moteur calcule l’adresse effective à partir des informations de registre actuelles et l’affiche.

[out, optional] Buffer

Reçoit l’instruction désassemblé. Si La mémoire tampon a la valeur NULL, ces informations ne sont pas retournées.

[in] BufferSize

Spécifie la taille, en caractères, de la mémoire tampon .

[out, optional] DisassemblySize

Reçoit la taille, en caractères, de l’instruction désassemblé. Si DésassemblementSize a la valeur NULL, ces informations ne sont pas retournées.

[out] EndOffset

Reçoit l’emplacement dans la mémoire de la cible de l’instruction suivant l’instruction désassemblé.

Valeur retournée

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez Valeurs de retour .

Code de retour	Description
S_OK	La méthode a réussi.
S_FALSE	La méthode a réussi. Toutefois, la mémoire tampon était trop petite pour contenir l’instruction désassemblé et l’instruction a été tronquée pour s’adapter.

Remarques

Le langage d’assembly dépend du type de processeur effectif du système cible. Pour plus d’informations sur le langage d’assembly, consultez la documentation du processeur.

Les options de désassemblement retournées par GetAssemblyOptions affectent l’opération de cette méthode.

Pour obtenir une vue d’ensemble de l’utilisation de l’assembly dans les applications de débogueur, consultez Débogage en mode Assembly. Pour plus d’informations sur l’utilisation de l’assembly avec l’API du moteur de débogueur, consultez Instructions d’assemblage et de désassemblement.