Fonction VideoPortQueryPerformanceCounter (video.h)

Article
02/29/2024

La fonction VideoPortQueryPerformanceCounter fournit le meilleur nombre d’exécutions disponibles dans le système.

Syntaxe

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

Paramètres

HwDeviceExtension

[in] Pointeur vers l’extension de périphérique du pilote miniport.

PerformanceFrequency

[out, facultatif] Pointeur facultatif vers une variable qui doit recevoir la fréquence du compteur de performances.

Valeur retournée

VideoPortQueryPerformanceCounter retourne la valeur du compteur de performances en unités de cycles.

Remarques

VideoPortQueryPerformanceCounter retourne toujours un entier 64 bits représentant le nombre de cycles. L’accumulation du nombre commence au démarrage du système. Le nombre est en cycles ; la fréquence est signalée par PerformanceFrequency si ce paramètre facultatif est fourni.

La résolution du minuteur utilisé pour accumuler le nombre actuel peut être obtenue en spécifiant PerformanceFrequency. Par exemple, si le PerformanceFrequency retourné est de 2 millions, chaque graduation est de 1/2 millionième de seconde. Chaque incrément de 1/x millionième du décompte correspond à une seconde de temps écoulé.

VideoPortQueryPerformanceCounter est destiné à l’horodatage des paquets ou au calcul des mesures de performances et de capacité. Il n’est pas destiné à mesurer le temps écoulé, à calculer des décrochages ou des attentes, ni à des itérations.

Utilisez cette routine aussi rarement que possible. Selon la plateforme, VideoPortQueryPerformanceCounter peut désactiver les interruptions à l’échelle du système pendant un intervalle minimal. Par conséquent, le fait d’appeler cette routine fréquemment ou à plusieurs reprises, comme dans une itération, va à l’encontre de son objectif de retourner des informations d’horodatage très précises et en cours d’exécution. L’appel de cette routine trop fréquemment peut dégrader les performances d’E/S pour le pilote appelant et pour le système dans son ensemble.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	video.h (incluez Video.h)
Bibliothèque	Videoprt.lib
DLL	Videoprt.sys
IRQL	N’importe quel niveau

Partager via