VideoPortQueryPerformanceCounter-Funktion (video.h)

Artikel
02/07/2025

Die VideoPortQueryPerformanceCounter--Funktion stellt die feinstkörnige Ausführungsanzahl bereit, die im System verfügbar ist.

Syntax

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

Parameter

HwDeviceExtension

[in] Zeigen Sie auf die Geräteerweiterung des Miniporttreibers.

PerformanceFrequency

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

Rückgabewert

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

Bemerkungen

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

Die Auflösung des Zeitgebers, der zum Ansammeln der aktuellen Anzahl verwendet wird, kann durch Angabe PerformanceFrequencyabgerufen werden. Wenn die zurückgegebene PerformanceFrequency- beispielsweise 2 Millionen beträgt, beträgt jeder Teilstrich 1/2 Millionstel einer Sekunde. Jede 1/x Millionstel Inkrement der Anzahl entspricht einer Sekunde verstrichener Zeit.

VideoPortQueryPerformanceCounter ist für Zeitstempelpakete oder für die Berechnung von Leistungs- und Kapazitätsmessungen vorgesehen. Es ist nicht für die Messung der verstrichenen Zeit, für das Berechnen von Ständen oder Wartezeiten oder für Iterationen vorgesehen.

Verwenden Sie diese Routine so selten wie möglich. Je nach Plattform können VideoPortQueryPerformanceCounter- systemweite Unterbrechungen für ein minimales Intervall deaktivieren. Folglich wird diese Routine häufig oder wiederholt aufgerufen, wie in einer Iteration, ihren Zweck, sehr feinkörnige, laufende Zeitstempelinformationen zurückzugeben. Das Aufrufen dieser Routine zu häufig kann die E/A-Leistung für den anrufenden Treiber und das gesamte System beeinträchtigen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP
Zielplattform-	Desktop
Header-	video.h (video.h einschließen)
Library	Videoprt.lib
DLL-	Videoprt.sys
IRQL-	Beliebige Ebene

Freigeben über