VideoPortQueryPerformanceCounter-Funktion (video.h)
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 |