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

Article
02/23/2024

La méthode SetAssemblyOptions définit les options d’assembly et de désassemblement qui affectent la façon dont le moteur du débogueur assemble et désassemble les instructions du processeur pour la cible.

Syntaxe

HRESULT SetAssemblyOptions(
  [in] ULONG Options
);

Paramètres

[in] Options

Spécifie les nouvelles options d’assembly et de désassemblement à utiliser par le moteur de débogueur. Les options sont définies par bits ; elle remplacera les options d’assemblage et de désassemblement existantes. Pour connaître les valeurs possibles, consultez Remarques. DEBUG_ASMOPT_DEFAULT pouvez être utilisé pour définir les options par défaut.

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

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.

Les options d’assemblage et de désassemblement affectent la façon dont le moteur du débogueur assemble et désassemble les instructions du processeur pour la cible.

Les options sont représentées par un bitset avec les indicateurs de bits suivants.

Constant	Description
DEBUG_ASMOPT_VERBOSE	Lorsque ce bit est défini, des informations supplémentaires sont incluses dans le désassemblement. Cela équivaut à l’option détaillée dans la commande .asm .
DEBUG_ASMOPT_NO_CODE_BYTES	Lorsque ce bit est défini, les octets bruts d’une instruction ne sont pas inclus dans le désassemblement. Cela équivaut à l’option no_code_bytes dans la commande .asm .
DEBUG_ASMOPT_IGNORE_OUTPUT_WIDTH	Lorsque ce bit est défini, le débogueur ignore la largeur de l’affichage de sortie lors de la mise en forme des instructions pendant le désassemblage. Cela équivaut à l’option ignore_output_width dans la commande .asm .
DEBUG_ASMOPT_SOURCE_LINE_NUMBER	Lorsque ce bit est défini, chaque ligne de la sortie de désassemblement est précédée du numéro de ligne du code source fourni par les informations de symbole. Cela équivaut à l’option source_line dans la commande .asm .

En outre, la valeur DEBUG_ASMOPT_DEFAULT représente l’ensemble par défaut d’options d’assembly et de désassemblement. Cela signifie que toutes les options du tableau précédent sont désactivées.