Metode IDebugControl3::SetAssemblyOptions (dbgeng.h)

Artikel
08/07/2023

Metode SetAssemblyOptions menetapkan opsi perakitan dan pembbongkaran yang memengaruhi cara mesin debugger merakit dan membongkar instruksi prosesor untuk target.

Sintaks

HRESULT SetAssemblyOptions(
  [in] ULONG Options
);

Parameter

[in] Options

Menentukan opsi rakitan dan pembbongkaran baru yang akan digunakan oleh mesin debugger. Opsi adalah bit-set; ini akan menggantikan opsi rakitan dan pembbongkaran yang ada. Untuk nilai yang mungkin, lihat Keterangan. DEBUG_ASMOPT_DEFAULT dapat digunakan untuk mengatur opsi default.

Nilai kembali

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

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.

Keterangan

Untuk informasi selengkapnya tentang menggunakan rakitan dengan API mesin debugger, lihat Instruksi Perakitan dan Pembongkaran.

Opsi perakitan dan pembbongkaran memengaruhi bagaimana mesin debugger merakit dan membongkar instruksi prosesor untuk target.

Opsi diwakili oleh bitset dengan bendera bit berikut.

Terus-menerus	Deskripsi
DEBUG_ASMOPT_VERBOSE	Ketika bit ini diatur, informasi tambahan disertakan dalam pembbongkaran. Ini setara dengan opsi verbose dalam perintah .asm .
DEBUG_ASMOPT_NO_CODE_BYTES	Ketika bit ini diatur, byte mentah untuk instruksi tidak disertakan dalam pembbongkaran. Ini setara dengan opsi no_code_bytes dalam perintah .asm .
DEBUG_ASMOPT_IGNORE_OUTPUT_WIDTH	Ketika bit ini diatur, debugger mengabaikan lebar tampilan output saat memformat instruksi selama pembbongkaran. Ini setara dengan opsi ignore_output_width dalam perintah .asm .
DEBUG_ASMOPT_SOURCE_LINE_NUMBER	Ketika bit ini diatur, setiap baris output pembbongkaran diawali dengan nomor baris kode sumber yang disediakan oleh informasi simbol. Ini setara dengan opsi source_line dalam perintah .asm .

Selain itu, nilai DEBUG_ASMOPT_DEFAULT mewakili kumpulan default opsi perakitan dan pembbongkaran. Ini berarti bahwa semua opsi dalam tabel sebelumnya dinonaktifkan.