VideoPortQueryPerformanceCounter, fonction (video.h)

La fonction VideoPortQueryPerformanceCounter fournit le nombre d’exécutions le plus précis disponible 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 de retour

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

Remarques

VideoPortQueryPerformanceCounter retourne toujours un entier 64 bits représentant le nombre de graduations. L’accumulation du nombre commence lorsque le système est démarré. 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 nombre correspond à une seconde de temps écoulé.

VideoPortQueryPerformanceCounter est destiné aux paquets d’horodatage ou au calcul des performances et des mesures de capacité. Il n’est pas destiné à mesurer le temps écoulé, à calculer des blocages ou des attentes, ou à 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, l’appel de cette routine fréquemment ou à plusieurs reprises, comme dans une itération, défait son objectif de retourner des informations d’horodatage très affinées et en cours d’exécution. L’appel de cette routine trop fréquemment peut dégrader les performances des E/S pour le pilote appelant et pour le système dans son ensemble.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP
plateforme cible	Bureau
d’en-tête	video.h (include Video.h)
bibliothèque	Videoprt.lib
DLL	Videoprt.sys
IRQL	N’importe quel niveau