Fungsi KeQuerySystemTimePrecise (wdm.h)

Artikel
08/08/2023

Rutinitas KeQuerySystemTimePrecise mengambil waktu sistem saat ini, dan lebih tepat daripada rutinitas KeQuerySystemTime .

Sintaks

void KeQuerySystemTimePrecise(
  [out] PLARGE_INTEGER CurrentTime
);

Parameter

[out] CurrentTime

Penunjuk ke variabel LARGE_INTEGER tempat rutin menulis waktu sistem saat ini.

Nilai kembali

Tidak ada

Keterangan

Waktu sistem adalah hitungan interval 100 nanodetik sejak 1 Januari 1601. Nilai ini dihitung untuk zona waktu GMT. Untuk menyesuaikan nilai ini untuk zona waktu lokal, panggil rutinitas ExSystemTimeToLocalTime .

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

Untuk memberikan nilai waktu sistem yang lebih akurat daripada KeQuerySystemTime, KeQuerySystemTimePrecise menggunakan penghitung kinerja sistem untuk mengukur waktu yang berlalu sejak interupsi timer jam terakhir, dan menambahkan waktu ini ke waktu jam sistem yang dihitungnya dari jumlah timer jam. Waktu sistem yang dilaporkan oleh KeQuerySystemTimePrecise akurat untuk dalam mikrosekon.

Pada beberapa platform perangkat keras, panggilan KeQuerySystemTimePrecise mungkin lebih lambat dari panggilan KeQuerySystemTime . Alasannya adalah bahwa KeQuerySystemTimePrecise membaca penghitung kinerja, yang dapat memperkenalkan penundaan tambahan. Untuk informasi selengkapnya, lihat KeQueryPerformanceCounter.

Panggil rutinitas KeQueryTimeIncrement untuk menentukan durasi jam sistem.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia dimulai dengan Windows 8.
Target Platform	Universal
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	Tingkat apa pun