Fungsi QueryPerformanceCounter (profileapi.h)

Mengambil nilai penghitung kinerja saat ini, yang merupakan stempel waktu resolusi tinggi (<1us) yang dapat digunakan untuk pengukuran interval waktu.

Syntax

BOOL QueryPerformanceCounter(
  [out] LARGE_INTEGER *lpPerformanceCount
);

Parameter-parameternya

[out] lpPerformanceCount

Penunjuk ke variabel yang menerima nilai penghitung kinerja saat ini, dalam hitungan.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError. Pada sistem yang menjalankan Windows XP atau yang lebih baru, fungsi akan selalu berhasil ketika diberikan parameter yang valid dan dengan demikian tidak akan pernah mengembalikan nol.

Komentar

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

Examples

// Gets the current number of ticks from QueryPerformanceCounter. Throws an
// exception if the call to QueryPerformanceCounter fails.
static inline int64_t GetTicks()
{
    LARGE_INTEGER ticks;
    if (!QueryPerformanceCounter(&ticks))
    {
        winrt::throw_last_error();
    }
    return ticks.QuadPart;
}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop | Aplikasi UWP]
Platform Target	Windows
Header	profileapi.h (termasuk Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

Memperoleh stempel waktu resolusi tinggi

Konseptual

GetSystemTimePreciseAsFileTime

KeQueryPerformanceCounter

QueryPerformanceFrequency

Referensi

Waktu

Timer