Metode IDebugRegisters2::GetValues (dbgeng.h)

Artikel
08/07/2023

Metode GetValues mendapatkan nilai dari beberapa register target.

Sintaks

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

Parameter

[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.

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.
E_UNEXPECTED	Target tidak dapat diakses, atau salah satu register tidak dapat diakses.
E_INVALIDARG	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

GetValues mendapatkan nilai dari beberapa register target.

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.

Untuk menerima nilai hanya dari satu register, gunakan metode GetValue sebagai gantinya.

Metode GetValues2 melakukan tugas yang sama dengan metode ini tetapi juga memungkinkan sumber register ditentukan.

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