Metode IDebugDataSpaces4::ReadProcessorSystemData (dbgeng.h)

  • Artikel

Metode ReadProcessorSystemData mengembalikan data tentang prosesor yang ditentukan.

Sintaks

HRESULT ReadProcessorSystemData(
  [in]            ULONG  Processor,
  [in]            ULONG  Index,
  [out]           PVOID  Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG DataSize
);

Parameter

[in] Processor

Menentukan prosesor yang datanya akan dibaca.

[in] Index

Menentukan tipe data yang akan dibaca. Tabel berikut berisi nilai yang valid. Setelah berhasil diselesaikan, data yang dikembalikan dalam buffer Buffer memiliki jenis yang ditentukan oleh kolom tengah.

Nilai Deskripsi
DEBUG_DATA_KPCR_OFFSET Mengembalikan alamat virtual Wilayah Kontrol Prosesor (PCR) prosesor.

Dalam hal ini, buffer argumen dapat dianggap memiliki jenis PULONG64.
DEBUG_DATA_KPRCB_OFFSET Mengembalikan alamat virtual Blok Kontrol Prosesor (PRCB) prosesor.

Dalam hal ini, buffer argumen dapat dianggap memiliki jenis PULONG64.
DEBUG_DATA_KTHREAD_OFFSET Mengembalikan alamat virtual struktur KTHREAD untuk utas sistem yang berjalan pada prosesor.

Dalam hal ini, buffer argumen dapat dianggap memiliki jenis PULONG64.
DEBUG_DATA_BASE_TRANSLATION_VIRTUAL_OFFSET Mengembalikan alamat virtual dasar informasi halaman yang dimiliki oleh sistem operasi atau prosesor. Alamat dan konten di alamat bergantung pada prosesor dan sistem operasi.

Dalam hal ini, buffer argumen dapat dianggap memiliki jenis PULONG64.
DEBUG_DATA_PROCESSOR_IDENTIFICATION Mengembalikan deskripsi prosesor.

Dalam hal ini, buffer argumen dapat dianggap memiliki jenis PDEBUG_PROCESSOR_IDENTIFICATION_ALL .
DEBUG_DATA_PROCESSOR_SPEED Mengembalikan kecepatan prosesor di MHz. Ini mungkin tidak berfungsi dalam sesi tertentu.

Dalam hal ini, buffer argumen dapat dianggap memiliki jenis PULONG.

[out] Buffer

Menerima data prosesor. Setelah berhasil menyelesaikan metode , konten buffer ini dapat diakses dengan mentransmisikan Buffer ke jenis yang ditentukan dalam tabel di atas.

[in] BufferSize

Menentukan ukuran dalam byte buffer Buffer. Ini adalah jumlah maksimum byte yang akan dikembalikan.

[out, optional] DataSize

Menerima ukuran data dalam byte. Jika DataSizeNULL, informasi ini tidak dikembalikan.

Nilai kembali

Menampilkan kode Deskripsi
S_OK
 Metode berhasil.
 

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

Keterangan

Metode ini hanya tersedia dalam penelusuran kesalahan mode kernel.

Untuk informasi tentang struktur PCR, PRCB, dan KTHREAD, serta informasi tentang tabel penomoran halaman, lihat Microsoft Windows Internals oleh David Solomon dan Mark Russinovich.

Persyaratan

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