Fungsi QueryUnbiasedInterruptTimePrecise (realtimeapiset.h)

Artikel
03/01/2024

Mendapatkan jumlah interupsi-waktu yang tidak bias saat ini, dalam bentuk yang lebih tepat daripada QueryUnbiasedInterruptTime . Jumlah interupsi-waktu yang tidak bias tidak termasuk waktu yang dihabiskan sistem dalam tidur atau hibernasi.

Sintaks

void QueryUnbiasedInterruptTimePrecise(
  [out] PULONGLONG lpUnbiasedInterruptTimePrecise
);

Parameter

[out] lpUnbiasedInterruptTimePrecise

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

Nilai kembali

Tidak ada

Keterangan

QueryUnbiasedInterruptTimePrecise mirip dengan rutinitas QueryUnbiasedInterruptTime , tetapi lebih tepat. Waktu interupsi yang dilaporkan oleh QueryUnbiasedInterruptTime didasarkan pada tick terbaru timer jam sistem. Timer jam sistem adalah timer perangkat keras yang secara berkala menghasilkan gangguan untuk jam sistem. Periode seragam antara interupsi timer jam sistem disebut sebagai jam sistem, dan biasanya dalam kisaran 0,5 milidetik hingga 15,625 milidetik, tergantung pada platform perangkat keras. Nilai waktu interupsi yang diambil oleh QueryUnbiasedInterruptTime akurat dalam jam sistem.

Untuk memberikan nilai waktu sistem yang lebih tepat daripada QueryUnbiasedInterruptTime, QueryUnbiasedInterruptTimePrecise membaca perangkat keras timer secara langsung, oleh karena itu panggilan QueryUnbiasedInterruptTimePrecise bisa lebih lambat daripada panggilan QueryUnbiasedInterruptTime .

Panggil rutinitas KeQueryTimeIncrement untuk menentukan durasi jam sistem.

Lihat juga Komentar di QueryUnbiasedInterruptTime.

Catatan Fungsi QueryUnbiasedInterruptTimePrecise menghasilkan hasil yang berbeda pada build Windows debug ("diperiksa"), karena jumlah interupsi-waktu dan jumlah tick ditingkatkan sekitar 49 hari. Ini membantu mengidentifikasi bug yang mungkin tidak terjadi sampai sistem berjalan untuk waktu yang lama. Build yang dicentang tersedia untuk pelanggan MSDN melalui situs Web Microsoft Developer Network (MSDN ).

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

Persyaratan

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