IReferenceClockTimerControl ::SetDefaultTimerResolution, méthode (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.]

La SetDefaultTimerResolution méthode définit la résolution minimale du minuteur.

Syntaxe

HRESULT SetDefaultTimerResolution(
  [in] REFERENCE_TIME timerResolution
);

Paramètres

[in] timerResolution

Résolution minimale du minuteur, en unités de 100 nanosecondes. Si la valeur est égale à zéro, l’horloge de référence annule sa requête précédente.

Valeur retournée

Retourne une valeur HRESULT . Les valeurs possibles sont les suivantes.

Code de retour	Description
S_OK	Réussite.

Remarques

L’horloge de référence tente de définir la période du minuteur sur timerResolution. La période réelle du minuteur peut différer en fonction du matériel. Pour trouver la résolution minimale et maximale du minuteur, appelez la fonction timeGetDevCaps . L’horloge de référence définit la résolution du minuteur en appelant timeBeginPeriod. Si timerResolution a la valeur 0, la méthode annule la requête du minuteur précédente en appelant timeEndPeriod. (Lorsque l’horloge de référence est détruite, elle annule automatiquement toute requête précédente.)

Si cette méthode n’est pas appelée, l’horloge de référence définit la résolution du minuteur sur 1 milliseconde. Pour obtenir les meilleures performances de gestion de l’alimentation, il est recommandé d’appeler cette méthode avec la valeur zéro. Cela remplace le paramètre par défaut de l’horloge de 1 milliseconde. Si des filtres dans le graphique nécessitent une résolution de minuteur plus élevée, ils peuvent appeler timeBeginPeriod individuellement. En règle générale, seuls les convertisseurs doivent nécessiter une résolution de minuteur particulière.

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)
Bibliothèque	Strmiids.lib

Voir aussi

Codes d’erreur et de réussite

IReferenceClockTimerControl, interface