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

Статья
02/07/2025

Функция 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 (include Video.h)
библиотеки	Videoprt.lib
DLL	Videoprt.sys
IRQL	Любой уровень

Поделиться через