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 可以停用全系統中斷，以最少的間隔。因此，如反覆項目一樣，經常或重複呼叫這個例程，會失敗其傳回非常精細且執行時間戳資訊的目的。呼叫此例程太頻繁可能會降低呼叫驅動程式和整個系統的 I/O 效能。