videoPortQueryPerformanceCounter 函数 (video.h)

  • 项目

VideoPortQueryPerformanceCounter 函数提供系统中可用的最精细的运行计数。

语法

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

参数

HwDeviceExtension

[in]指向微型端口驱动程序的设备扩展的指针。

PerformanceFrequency

[out，可选]指向要接收性能计数器频率的变量的可选指针。

返回值

VideoPortQueryPerformanceCounter 以刻度为单位返回性能计数器值。

注解

VideoPortQueryPerformanceCounter 始终返回表示时钟周期数的 64 位整数。 在启动系统时开始累积计数。 计数以刻度为单位;如果提供了此可选参数，则 PerformanceFrequency 报告频率。

可通过指定 PerformanceFrequency 来获取用于累积当前计数的计时器的分辨率。 例如，如果返回的 PerformanceFrequency 为 200 万，则每个刻度为 1/2 百万分之一秒。 计数的每 1/x 百万分之一递增对应于一秒的已用时间。

VideoPortQueryPerformanceCounter 用于时间戳数据包或计算性能和容量度量。 它不用于测量运行时间、计算停止或等待或迭代。

请尽可能不经常使用此例程。 根据平台的不同， VideoPortQueryPerformanceCounter 可以在最小间隔内禁用系统范围的中断。 因此，像在迭代中一样频繁或重复调用此例程会违背其返回非常精细的运行时间戳信息的目的。 过于频繁地调用此例程可能会降低调用驱动程序和整个系统的 I/O 性能。

要求

要求 值
最低受支持的客户端 Windows XP
目标平台 桌面
标头 video.h (包括 Video.h)
Library Videoprt.lib
DLL Videoprt.sys
IRQL 任何级别