通过

VideoPortQueryPerformanceCounter 函数 （video.h）

  • 项目

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

语法

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

参数

HwDeviceExtension

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

PerformanceFrequency

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

返回值

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

言论

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

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

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

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

要求

要求 价值
最低支持的客户端 Windows XP
目标平台 桌面
标头 video.h （include Video.h）
库 Videoprt.lib
DLL Videoprt.sys
IRQL 任何级别