Функция QueryUnbiasedInterruptTimePrecise (realtimeapiset.h)

Статья
08/25/2023

Возвращает текущее число беспристрастных прерываний в более точной форме, чем QueryUnbiasedInterruptTime . Непредвзятый подсчет времени прерываний не включает время, которое система проводит в спящем режиме или гибернации.

Синтаксис

void QueryUnbiasedInterruptTimePrecise(
  [out] PULONGLONG lpUnbiasedInterruptTimePrecise
);

Параметры

[out] lpUnbiasedInterruptTimePrecise

Указатель на ULONGLONG, в котором требуется получить беспристрастное количество времени прерываний в единицах системного времени 100 наносекунд. Разделите на десять миллионов, или 1e7, чтобы получить секунды (есть 1e9 наносекунд в секунду, так что есть 1e7 100 наносекунд в секунду).

Возвращаемое значение

None

Remarks

QueryUnbiasedInterruptTimePrecise похож на подпрограмму QueryUnbiasedInterruptTime , но является более точным. Время прерывания, сообщаемое QueryUnbiasedInterruptTime , основано на последнем тактовом таймере системных часов. Таймер системных часов — это аппаратный таймер, который периодически создает прерывания для системных часов. Равномерный период между прерываниями таймера системных часов называется тактом системных часов и обычно находится в диапазоне от 0,5 до 15,625 миллисекунд в зависимости от аппаратной платформы. Значение времени прерывания, полученное queryUnbiasedInterruptTime , является точным в тактах системных часов.

Чтобы задать значение системного времени, более точное, чем у QueryUnbiasedInterruptTime, QueryUnbiasedInterruptTimePrecise считывает оборудование таймера напрямую, поэтому вызов QueryUnbiasedInterruptTimePrecise может быть медленнее, чем вызов QueryUnbiasedInterruptTime .

Вызовите подпрограмму KeQueryTimeIncrement , чтобы определить длительность такта системных часов.

См. также примечания в QueryUnbiasedInterruptTime.

Примечание Функция QueryUnbiasedInterruptTimePrecise дает различные результаты в отладочных сборках Windows ("проверено"), так как количество прерываний и число тактов расширены примерно на 49 дней. Это помогает выявлять ошибки, которые могут не возникать, пока система не будет работать в течение длительного времени. Проверенная сборка доступна подписчикам MSDN на веб-сайте Microsoft Developer Network (MSDN).

Чтобы скомпилировать приложение, использующее эту функцию, определите _WIN32_WINNT как 0x0601 или более поздней версии. Дополнительные сведения см. в разделе Использование заголовков Windows.

Требования

Требование	Значение
Минимальная версия клиента	Windows 10 [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2016 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	realtimeapiset.h
Библиотека	Kernel32.lib
DLL	Kernel32.dll