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

Статья
07/16/2024

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

Синтаксис

void QueryUnbiasedInterruptTimePrecise(
  [out] PULONGLONG lpUnbiasedInterruptTimePrecise
);

Параметры

[out] lpUnbiasedInterruptTimePrecise

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

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

Никакой

Замечания

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

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

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

Кроме того, см. примечания в QueryUnbiasedInterruptTime.

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

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10 [классические приложения \| Приложения UWP]
минимальный поддерживаемый сервер	Windows Server 2016 [классические приложения \| Приложения UWP]
целевая платформа	Виндоус
заголовка	realtimeapiset.h
библиотеки	Kernel32.lib
DLL	Kernel32.dll