IDebugControl::Assemble メソッド (dbgeng.h)

Assemble メソッドは、1 つのプロセッサ命令をアセンブルします。アセンブリされた命令は、ターゲットのメモリに配置されます。

構文

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

[in] Offset

アセンブリされた命令を配置するターゲットのメモリ内の場所を指定します。

[in] Instr

アセンブルする命令を指定します。命令は、ターゲットの有効なプロセッサの種類 ( SetEffectiveProcessorType によって返されます) に従ってアセンブルされます。

[out] EndOffset

アセンブリされた命令の直後にターゲットのメモリ内の場所を受け取ります。 EndOffset は、複数の命令を組み立てるときに使用できます。

リターンコード	説明
S_OK	メソッドは正常に実行されました。

このメソッドは、エラー値を返すこともできます。詳細については、「戻り値」を参照してください。

アセンブリ言語は、ターゲットコンピューターの有効なプロセッサの種類によって異なります。アセンブリ言語の詳細については、プロセッサのドキュメントを参照してください。

メモAssemble メソッドと AssembleWide メソッドは、一部のアーキテクチャではサポートされていません。また、一部のアーキテクチャでは、すべての命令がサポートされているわけではありません。

GetAssemblyOptions によって返されるアセンブリ言語オプションは、このメソッドの操作に影響します。

デバッガーアプリケーションでのアセンブリの使用の概要については、「アセンブリモードでのデバッグ」を参照してください。デバッガーエンジン API でのアセンブリの使用の詳細については、「アセンブリと逆アセンブルの手順」を参照してください。

要件	値
対象プラットフォーム	デスクトップ
Header	dbgeng.h (Dbgeng.h を含む)