Metode IDebugRegisters2::GetValues2 (dbgeng.h)
Metode GetValues2 mengambil nilai beberapa register target.
Sintaks
HRESULT GetValues2(
[in] ULONG Source,
[in] ULONG Count,
[in, optional] PULONG Indices,
[in] ULONG Start,
[out] PDEBUG_VALUE Values
);
Parameter
[in] Source
Menentukan sumber register untuk kueri.
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 yang nilainya diminta.
[in, optional] Indices
Menentukan array yang berisi indeks register untuk mendapatkan nilai. Jumlah elemen dalam array ini adalah Count. Jika IndeksNULL, Mulai digunakan sebagai gantinya.
[in] Start
Jika IndeksNULL, register akan dibaca berturut-turut mulai dari indeks ini. Jika tidak, itu diabaikan.
[out] Values
Menerima nilai register. Jumlah elemen yang dipegang array ini adalah Count. Lihat DEBUG_VALUE untuk deskripsi jenis parameter ini.
Mengembalikan nilai
Daftar ini tidak berisi semua kesalahan yang mungkin terjadi. Untuk daftar kemungkinan kesalahan, lihat Nilai HRESULT.
Menampilkan kode | Deskripsi |
---|---|
|
Metode berhasil. |
|
Nilai indeks salah satu register lebih besar dari jumlah register pada komputer target. Hasil parsial mungkin telah diperoleh; register yang tidak dapat dibaca akan memiliki jenis DEBUG_VALUE_INVALID. |
Keterangan
Jika nilai yang dikembalikan tidak S_OK, beberapa register mungkin masih telah dibaca. Jika target tidak dapat diakses, jenis pengembalian E_UNEXPECTED dan Nilai tidak berubah. Jika tidak, Nilai akan berisi hasil parsial dan register yang tidak dapat dibaca akan memiliki jenis DEBUG_VALUE_INVALID. Ambiguitas dalam kasus nilai yang dikembalikan E_UNEXPECTED dapat dihindari dengan mengatur memori Nilai ke nol sebelum memanggil metode ini.
Metode GetValues 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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk