Méthode IDebugControl3 ::OutputDisassembly (dbgeng.h)

Article
02/23/2024

La méthode OutputDisassembly désassemble une instruction de processeur et envoie le désassemblage 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 Entrée et 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, sortez 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 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.

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ésassemblement.