Fungsi QueryInterruptTime (realtimeapiset.h)

Artikel
07/16/2024

Mendapatkan jumlah waktu interupsi saat ini. Untuk jumlah yang lebih tepat, gunakan QueryInterruptTimePrecise.

Sintaksis

void QueryInterruptTime(
  [out] PULONGLONG lpInterruptTime
);

Parameter

[out] lpInterruptTime

Pointer ke ULONGLONG untuk menerima jumlah interupsi-waktu dalam unit waktu sistem 100 nanodetik. Bagi dengan sepuluh juta, atau 1e7, untuk mendapatkan detik (ada 1e9 nanodetik dalam detik, jadi ada 1e7 100 nanodetik dalam detik).

Mengembalikan nilai

Tidak

Komentar

Jumlah interupsi-waktu dimulai pada nol ketika sistem dimulai dan bertambah pada setiap jam yang diinterupsi oleh panjang jam centang. Panjang tick jam yang tepat tergantung pada perangkat keras yang mendasar dan dapat bervariasi di antara sistem.

Tidak seperti waktu sistem, jumlah waktu interupsi tidak tunduk pada penyesuaian oleh pengguna atau layanan waktu Windows. Aplikasi dapat menggunakan jumlah interupsi-waktu untuk mengukur durasi yang lebih halus daripada yang dimungkinkan dengan waktu sistem. Aplikasi yang membutuhkan presisi yang lebih besar daripada jumlah waktu interupsi harus menggunakan timer resolusi tinggi . Gunakan fungsi QueryPerformanceFrequency untuk mengambil frekuensi timer resolusi tinggi dan fungsi QueryPerformanceCounter untuk mengambil nilai penghitung.

Resolusi timer yang ditetapkan oleh fungsi timeBeginPeriod dan timeEndPeriod memengaruhi resolusi fungsi QueryInterruptTime . Namun, meningkatkan resolusi timer tidak disarankan karena dapat mengurangi performa sistem secara keseluruhan dan meningkatkan konsumsi daya sistem dengan mencegah prosesor memasuki status penghematan daya. Sebagai gantinya, aplikasi harus menggunakan timer resolusi tinggi.

Note Fungsi QueryInterruptTime menghasilkan hasil yang berbeda pada build Windows debug ("diperiksa"), karena jumlah waktu interupsi dan jumlah tick ditingkatkan sekitar 49 hari. Ini membantu mengidentifikasi bug yang mungkin tidak terjadi sampai sistem berjalan untuk waktu yang lama.

Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan _WIN32_WINNT sebagai 0x0601 atau yang lebih baru. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows 10 [aplikasi desktop \| Aplikasi UWP]
server minimum yang didukung	Windows Server 2016 [aplikasi desktop \| Aplikasi UWP]
Platform Target	Windows
Header	realtimeapiset.h
Pustaka	Mincore.lib
DLL	Kernel32.dll