IDebugControl4 ::D isassembleWide, méthode (dbgeng.h)

Article
02/06/2025

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

Syntaxe

HRESULT DisassembleWide(
  [in]            ULONG64  Offset,
  [in]            ULONG    Flags,
  [out, optional] PWSTR    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 pouvant être défini est DEBUG_DISASM_EFFECTIVE_ADDRESS ; lorsqu’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 tampon est NULL, ces informations ne sont pas retournées.

[in] BufferSize

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

[out, optional] DisassemblySize

Reçoit la taille, en caractères, de l’instruction désassemblé. Si désassembler est 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 de retour

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

Retourner le code	Description
S_OK	La méthode a réussi.
S_FALSE	La méthode a réussi. Toutefois, mémoire tampon était trop petite pour contenir l’instruction désassemblée 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ésassemblage.