VideoPortQueryPerformanceCounter-Funktion (video.h)

Die VideoPortQueryPerformanceCounter-Funktion stellt die fein abgestufte Anzahl von Ausführungsvorgängen bereit, die im System verfügbar sind.

Syntax

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

Parameter

HwDeviceExtension

[in] Zeiger auf die Geräteerweiterung des Miniporttreibers.

PerformanceFrequency

[out, optional] Ein optionaler Zeiger auf eine Variable, die die Leistungsindikatorhäufigkeit empfangen soll.

Rückgabewert

VideoPortQueryPerformanceCounter gibt den Leistungsindikatorwert in Einheiten von Ticks zurück.

Hinweise

VideoPortQueryPerformanceCounter gibt immer eine 64-Bit-Ganzzahl zurück, die die Anzahl der Ticks darstellt. Das Sammeln der Anzahl beginnt, wenn das System gestartet wird. Die Anzahl ist in Ticks; die Häufigkeit wird von PerformanceFrequency gemeldet, wenn dieser optionale Parameter angegeben wird.

Die Auflösung des Timers, der zum Akkumulieren der aktuellen Anzahl verwendet wird, kann durch Angabe von PerformanceFrequency abgerufen werden. Wenn die zurückgegebene PerformanceFrequency beispielsweise 2 Millionen beträgt, ist jeder Tick 1/2 Millionstel Sekunde. Jeder 1/x millionstel Inkrement der Anzahl entspricht einer Sekunde verstrichener Zeit.

VideoPortQueryPerformanceCounter ist zum Zeitstempeln von Paketen oder zur Berechnung von Leistungs- und Kapazitätsmessungen vorgesehen. Es ist nicht für die Messung verstrichener Zeit, für das Berechnen von Ständen oder Wartezeiten oder für Iterationen vorgesehen.

Verwenden Sie diese Routine so selten wie möglich. Abhängig von der Plattform kann VideoPortQueryPerformanceCounter systemweite Interrupts für ein minimales Intervall deaktivieren. Daher verfehlt das häufige oder wiederholte Aufrufen dieser Routine, wie in einer Iteration, ihren Zweck, sehr fein abgestufte, laufende Zeitstempelinformationen zurückzugeben. Das zu häufige Aufrufen dieser Routine kann die E/A-Leistung für den aufrufenden Treiber und das gesamte System beeinträchtigen.

Anforderungen