Fungsi KeQueryPerformanceCounter (wdm.h)

Artikel
07/02/2025

Rutinitas KeQueryPerformanceCounter mengambil nilai dan frekuensi penghitung kinerja saat ini.

Gunakan KeQueryPerformanceCounter untuk memperoleh stempel waktu resolusi tinggi (<1μs) untuk pengukuran interval waktu.

Sintaksis

C++

NTHALAPI LARGE_INTEGER KeQueryPerformanceCounter(
  [out, optional] PLARGE_INTEGER PerformanceFrequency
);

Parameter

[out, optional] PerformanceFrequency

Pointer ke variabel yang KeQueryPerformanceCounter menulis frekuensi penghitung kinerja, dalam tick per detik. Parameter ini bersifat opsional dan dapat berupa NULL jika pemanggil tidak memerlukan nilai frekuensi penghitung.

Mengembalikan nilai

KeQueryPerformanceCounter mengembalikan nilai penghitung kinerja dalam satuan tick.

Komentar

KeQueryPerformanceCounter mengembalikan bilangan bulat 64-bit yang mewakili nilai penghitung nondekreasing monoton resolusi tinggi saat ini.

Untuk mendapatkan frekuensi penghitung kinerja, tentukan nilai penunjukNULL non- untuk parameter PerformanceFrequency. Frekuensi penghitung kinerja diperbaiki pada boot sistem dan konsisten di semua prosesor. Oleh karena itu, driver dapat menyimpan frekuensi penghitung kinerja selama inisialisasi.

Untuk informasi selengkapnya tentang fungsi ini dan penggunaannya, lihat Memperoleh stempel waktu resolusi tinggi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Tersedia dimulai dengan Windows 2000.
Platform Target	Universal
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka	Hal.lib
DLL	Hal.dll
IRQL	Tingkat apa pun