IDebugControl2::Merakit metode (dbgeng.h)

Artikel
02/27/2024

Metode Merakit merakit instruksi prosesor tunggal. Instruksi yang dirakit ditempatkan dalam memori target.

Sintaks

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

Parameter

[in] Offset

Menentukan lokasi dalam memori target untuk menempatkan instruksi yang dirakit.

[in] Instr

Menentukan instruksi untuk dirakit. Instruksi dirakit sesuai dengan jenis prosesor efektif target (dikembalikan oleh SetEffectiveProcessorType).

[out] EndOffset

Menerima lokasi dalam memori target segera setelah instruksi yang dirakit. EndOffset dapat digunakan saat menyusun beberapa instruksi.

Nilai kembali

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.

Metode ini juga dapat mengembalikan nilai kesalahan. Lihat Mengembalikan Nilai untuk detail selengkapnya.

Keterangan

Bahasa perakitan tergantung pada jenis prosesor komputer target yang efektif. Untuk informasi tentang bahasa perakitan, lihat dokumentasi prosesor.

Catatan Metode Merakit dan MerakitWide tidak didukung pada beberapa arsitektur, dan pada beberapa arsitektur lain tidak semua instruksi didukung.

Opsi bahasa perakitan--dikembalikan oleh GetAssemblyOptions--mempengaruhi operasi metode ini.

Untuk gambaran umum penggunaan assembly di aplikasi debugger, lihat Debugging dalam Mode Rakitan. Untuk informasi selengkapnya tentang menggunakan perakitan dengan API mesin debugger, lihat Instruksi Perakitan dan Pembongkaran.