Interface IReferenceClockTimerControl (strmif.h)

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

L’interface IReferenceClockTimerControl modifie la période du minuteur utilisée par une horloge de référence. Cette interface est exposée par l’horloge de référence système DirectShow.

Héritage

L’interface IReferenceClockTimerControl hérite de l’interface IUnknown. IReferenceClockTimerControl a également les types de membres suivants :

Méthodes

L’interface IReferenceClockTimerControl a ces méthodes.

IReferenceClockTimerControl ::GetDefaultTimerResolution La méthode GetDefaultTimerResolution retourne la résolution du minuteur qui a été demandée par l’horloge de référence.
IReferenceClockTimerControl ::SetDefaultTimerResolution La méthode SetDefaultTimerResolution définit la résolution minimale du minuteur.

Remarques

Par défaut, l’horloge de référence système dans DirectShow définit la période du minuteur sur la valeur minimale autorisée par le minuteur. En règle générale, cette valeur est de 1 milliseconde.

La période du minuteur est un paramètre global dans Windows. Une résolution plus élevée peut améliorer la précision des intervalles de délai d’attente dans les fonctions d’attente. Toutefois, il peut également réduire les performances globales du système, car le planificateur de threads bascule plus souvent les tâches. Des résolutions élevées peuvent également empêcher le système de gestion de l’alimentation du processeur d’entrer en mode d’économie d’énergie. La définition d’une résolution plus élevée n’améliore pas la précision du compteur de performances haute résolution.

L’objectif main de cette interface est de remplacer le paramètre de minuteur par défaut de l’horloge de référence. Pour ce faire, appelez SetDefaultTimerResolution avec la valeur zéro. Cela peut entraîner une résolution du minuteur plus faible, ce qui peut permettre à l’ordinateur de l’utilisateur de passer en mode d’économie d’énergie. (Le comportement réel dépend de nombreux autres facteurs, tels que les autres processus en cours d’exécution.) Le filtre DVD Navigator utilise cette interface, comme décrit ici.

Si un filtre DirectShow nécessite une résolution de minuteur plus élevée, il doit appeler timeBeginPeriod. En règle générale, cette exigence s’applique uniquement aux filtres de convertisseur.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	strmif.h (include Dshow.h)