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

Статья
07/16/2024

Возвращает текущее количество времени прерывания в более точной форме, чем QueryInterruptTime.

Синтаксис

void QueryInterruptTimePrecise(
  [out] PULONGLONG lpInterruptTimePrecise
);

Параметры

[out] lpInterruptTimePrecise

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

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

Никакой

Замечания

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

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

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

См. также замечания в QueryInterruptTime.

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

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

Требования

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