Fungsi KeQueryHardwareCounterConfiguration (ntddk.h)

  • Artikel

Rutinitas KeQueryHardwareCounterConfiguration mengkueri sistem operasi untuk daftar penghitung perangkat keras yang akan digunakan untuk pembuatan profil utas.

Sintaks

NTSTATUS KeQueryHardwareCounterConfiguration(
  [out] PHARDWARE_COUNTER CounterArray,
  [in]  ULONG             MaximumCount,
  [out] PULONG            Count
);

Parameter

[out] CounterArray

Penunjuk ke buffer yang dialokasikan penelepon tempat rutin menulis array elemen jenis HARDWARE_COUNTER. Setiap elemen array adalah struktur yang berisi informasi tentang penghitung perangkat keras. Array berisi satu elemen untuk setiap penghitung perangkat keras yang ditetapkan untuk pembuatan profil utas. Jika rutinitas gagal, ia tidak menulis apa pun ke buffer ini.

[in] MaximumCount

Menentukan jumlah maksimum elemen yang dapat ditulis rutin ke buffer yang diarahkan oleh parameter CounterArray . Ukuran buffer yang dialokasikan pemanggil harus setidaknya maximumCount * sizeof(HARDWARE_COUNTER) byte.

[out] Count

Penunjuk ke lokasi di mana rutinitas menulis jumlah elemen array yang telah ditulisnya ke buffer yang diarahkan oleh parameter CounterArray . Jika panjang buffer yang ditentukan oleh MaximumCount tidak cukup besar untuk memuat seluruh array, rutin menulis panjang yang diperlukan untuk *Hitung dan mengembalikan STATUS_BUFFER_TOO_SMALL.

Nilai kembali

KeQueryHardwareCounterConfiguration mengembalikan STATUS_SUCCESS jika panggilan berhasil. Kemungkinan nilai pengembalian kesalahan meliputi yang berikut ini:

Menampilkan kode Deskripsi
STATUS_BUFFER_TOO_SMALL Parameter MaximumCount menentukan panjang buffer yang tidak cukup besar untuk berisi informasi konfigurasi penghitung.
STATUS_NOT_IMPLEMENTED Rutinitas ini tidak diimplementasikan untuk arsitektur prosesor yang dijalankan pemanggil.

Keterangan

Di Windows 7, rutinitas ini hanya diimplementasikan untuk arsitektur berbasis x86, berbasis x64, dan berbasis Itanium. Jika pemanggil berjalan pada arsitektur prosesor yang tidak didukung, rutinitas mengembalikan STATUS_NOT_IMPLEMENTED.

Untuk mengatur konfigurasi penghitung perangkat keras yang akan digunakan untuk pembuatan profil utas, panggil rutinitas KeSetHardwareCounterConfiguration .

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Windows 7 dan versi Windows yang lebih baru.
Target Platform Universal
Header ntddk.h (termasuk Ntddk.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Lihat juga

HARDWARE_COUNTER

KeSetHardwareCounterConfiguration