Méthode IDebugControl ::Assemble (dbgeng.h)

Article
02/23/2024

La méthode Assemble assemble une instruction de processeur unique. L’instruction assemblée est placée dans la mémoire de la cible.

Syntaxe

HRESULT Assemble(
  [in]  ULONG64  Offset,
  [in]  PCSTR    Instr,
  [out] PULONG64 EndOffset
);

Paramètres

[in] Offset

Spécifie l’emplacement dans la mémoire de la cible pour placer l’instruction assemblée.

[in] Instr

Spécifie l’instruction à assembler. L’instruction est assemblée en fonction du type de processeur effectif de la cible (retourné par SetEffectiveProcessorType).

[out] EndOffset

Reçoit l’emplacement dans la mémoire de la cible immédiatement après l’instruction assemblée. EndOffset peut être utilisé lors de l’assemblage de plusieurs instructions.

Valeur retournée

Code de retour	Description
S_OK	La méthode a réussi.

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

Remarques

La langue de l’assembly dépend du type de processeur effectif de l’ordinateur cible. Pour plus d’informations sur le langage d’assembly, consultez la documentation du processeur.

Note Les méthodes Assemble et AssembleWide ne sont pas prises en charge sur certaines architectures, et sur d’autres architectures, toutes les instructions ne sont pas prises en charge.

Les options de langage d’assembly, retournées par GetAssemblyOptions, affectent le fonctionnement 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.