Metode IDebugRegisters2::SetValues2 (dbgeng.h)

Artikel
08/07/2023

Metode SetValues2 menetapkan nilai beberapa register target.

Sintaks

HRESULT SetValues2(
  [in]           ULONG        Source,
  [in]           ULONG        Count,
  [in, optional] PULONG       Indices,
  [in]           ULONG        Start,
  [in]           PDEBUG_VALUE Values
);

Parameter

[in] Source

Menentukan sumber register yang akan dikueri.

Nilai yang mungkin tercantum dalam tabel berikut ini.

Nilai	Daftarkan sumber
DEBUG_REGSRC_DEBUGGEE	Ambil informasi register dari target.
DEBUG_REGSRC_EXPLICIT	Ambil informasi register dari konteks register eksplisit saat ini.
DEBUG_REGSRC_FRAME	Ambil informasi register dari konteks register cakupan saat ini. Catatan Stack unwinding tidak menjamin pembaruan konteks register yang akurat, sehingga konteks register bingkai cakupan mungkin tidak akurat dalam semua kasus.

[in] Count

Menentukan jumlah register untuk mengatur nilai.

[in, optional] Indices

Menentukan array yang berisi indeks register untuk mengatur nilai. Jumlah elemen dalam array ini adalah Count. Jika IndeksNULL, Mulai digunakan sebagai gantinya.

[in] Start

Jika IndeksNULL, register akan diatur secara berturut-turut mulai dari indeks ini. Jika tidak, itu diabaikan.

[in] Values

Array yang berisi nilai untuk mengatur register. Jumlah elemen yang dipegang array ini adalah Count. Lihat DEBUG_VALUE untuk deskripsi jenis parameter ini.

Nilai kembali

Daftar ini tidak berisi semua kesalahan yang mungkin terjadi. Untuk daftar kemungkinan kesalahan, lihat Nilai HRESULT.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.

Keterangan

Mesin melakukan yang terbaik untuk mentransmisikan nilai dalam Nilai ke dalam jenis register; konversi ini sama dengan yang dilakukan oleh CoerceValue. Jika nilainya lebih besar dari apa yang dapat ditahan oleh register, bit yang paling tidak signifikan akan dihilangkan. Konversi floating-point dan bilangan bulat juga akan dilakukan jika perlu.

Jika nilai yang dikembalikan tidak S_OK, beberapa register mungkin masih telah ditetapkan.

Ketika subregister diubah, register yang berisinya juga diubah.

Metode SetValues melakukan tugas yang sama dengan metode ini tetapi selalu menggunakan target sebagai sumber register.

Untuk gambaran umum antarmuka IDebugRegisters dan metode terkait pendaftaran lainnya, lihat Mendaftar.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	dbgeng.h (termasuk DbgEng.h)

Lihat juga

IDebugRegisters2

SetValue

SetValues