Функция VideoPortQueryPerformanceCounter (video.h)

  • Статья

Функция VideoPortQueryPerformanceCounter предоставляет наиболее точное количество выполняемых данных, доступное в системе.

Синтаксис

VIDEOPORT_API LONGLONG VideoPortQueryPerformanceCounter(
  IN PVOID      HwDeviceExtension,
  OUT PLONGLONG PerformanceFrequency
);

Параметры

HwDeviceExtension

[in] Указатель на расширение устройства драйвера мини-порта.

PerformanceFrequency

[out, необязательный] Необязательный указатель на переменную, которая получает частоту счетчика производительности.

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

VideoPortQueryPerformanceCounter возвращает значение счетчика производительности в единицах тактов.

Комментарии

VideoPortQueryPerformanceCounter всегда возвращает 64-разрядное целое число, представляющее количество тактов. Накопление счетчика начинается при загрузке системы. Число в тактах; Частота сообщается PerformanceFrequency , если указан этот необязательный параметр.

Разрешение таймера, используемого для накопления текущего числа, можно получить, указав PerformanceFrequency. Например, если возвращаемое значение PerformanceFrequency равно 2 миллионам, каждый тик будет равен 1/2 миллионной секунды. Каждое 1/x миллионное приращение счетчика соответствует одной секунде затраченного времени.

VideoPortQueryPerformanceCounter предназначен для пакетов с отметками времени или для вычисления показателей производительности и емкости. Он не предназначен для измерения затраченного времени, для вычисления остановок или ожиданий, а также для итераций.

Используйте эту процедуру так редко, как это возможно. В зависимости от платформы VideoPortQueryPerformanceCounter может отключать прерывания на уровне системы с минимальным интервалом. Следовательно, частое или многократное вызов этой подпрограммы, как в итерации, не позволяет получить очень детализированную информацию о метке времени. Слишком частый вызов этой процедуры может снизить производительность операций ввода-вывода для вызывающего драйвера и системы в целом.

Требования

Требование Значение
Минимальная версия клиента Windows XP
Целевая платформа Персональный компьютер
Верхняя часть video.h (включить Video.h)
Библиотека Videoprt.lib
DLL Videoprt.sys
IRQL Любой уровень