IDebugControl3 ::OutputDisassembly, méthode (dbgeng.h)

Article
02/06/2025

La méthode OutputDisassembly désassemble une instruction de processeur et envoie le désassemblement aux rappels de sortie .

Syntaxe

HRESULT OutputDisassembly(
  [in]  ULONG    OutputControl,
  [in]  ULONG64  Offset,
  [in]  ULONG    Flags,
  [out] PULONG64 EndOffset
);

Paramètres

[in] OutputControl

Spécifie le contrôle de sortie qui détermine les rappels de sortie du client qui reçoivent la sortie. Pour connaître les valeurs possibles, consultez DEBUG_OUTCTL_XXX. Pour plus d’informations sur la sortie, consultez d’entrée et de sortie.

[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. Le tableau suivant répertorie les bits qui peuvent être définis.

Bit-Flag	Effet lors de la définition
DEBUG_DISASM_EFFECTIVE_ADDRESS	Calculez l’adresse effective à partir des informations de registre actuelles et affichez-la.
DEBUG_DISASM_MATCHING_SYMBOLS	Si l’adresse de l’instruction a une correspondance de symbole exacte, affichez le symbole.
DEBUG_DISASM_SOURCE_LINE_NUMBER	Incluez le numéro de ligne source de l’instruction dans la sortie.
DEBUG_DISASM_SOURCE_FILE_NAME	Incluez le nom du fichier source dans la sortie.

[out] EndOffset

Reçoit l’emplacement dans la mémoire de la cible de l’instruction qui suit 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.

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.

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.