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

Article
02/06/2025

La méthode assemble assemble une seule instruction de processeur. 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ée par SetEffectiveProcessorType).

[out] EndOffset

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

Valeur de retour

Retourner le code	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

Le langage d’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.

Remarque Les méthodes assemblez et AssembleWide ne sont pas prises en charge sur certaines architectures, et certaines autres architectures ne sont pas prises en charge.

Les options de langage d’assembly 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.