Fungsi QueryUnbiasedInterruptTime (realtimeapiset.h)

Mendapatkan jumlah waktu interupsi yang tidak bias saat ini, dalam satuan 100 nanodetik. Jumlah waktu interupsi yang tidak bias tidak termasuk waktu yang dihabiskan sistem dalam tidur atau hibernasi.

Sintaksis

BOOL QueryUnbiasedInterruptTime(
  PULONGLONG UnbiasedTime
);

Parameter

UnbiasedTime

TBD

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol. Jika fungsi gagal karena dipanggil dengan parameter null, nilai yang dikembalikan adalah nol.

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.

Jumlah waktu interupsi yang diambil oleh fungsi QueryUnbiasedInterruptTime hanya mencerminkan waktu sistem berada dalam status kerja. Oleh karena itu, jumlah interupsi-waktu tidak "bias" oleh waktu yang dihabiskan sistem dalam tidur atau hibernasi. Sistem ini menggunakan waktu interupsi bias untuk beberapa operasi, seperti memastikan bahwa timer relatif yang akan kedaluwarsa selama tidur kedaluwarsa segera setelah bangun.

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 QueryUnbiasedInterruptTime. 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 QueryUnbiasedInterruptTime menghasilkan hasil yang berbeda pada build Debug ("diperiksa") Windows, 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 7, Windows 8 [aplikasi desktop | Aplikasi UWP]
server minimum yang didukung	Windows Server 2008 R2 [aplikasi desktop | Aplikasi UWP]
Platform Target	Windows
Header	realtimeapiset.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

Waktu Interupsi

QueryInterruptTime

QueryInterruptTimePrecise

QueryUnbiasedInterruptTimePrecise

System Power States

Waktu Windows