Interface IReferenceClock (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 dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est 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 IReferenceClock fournit l’heure de référence pour le graphe de filtre.

Les filtres qui peuvent faire office d’horloge de référence peuvent exposer cette interface. Il est également exposé par l’horloge de référence système. Le gestionnaire de graphe de filtre utilise cette interface pour synchroniser le graphe de filtre. Les applications peuvent utiliser cette interface pour récupérer l’heure de référence actuelle ou pour demander une notification d’un temps écoulé.

Pour plus d’informations, consultez Heure et horloges dans DirectShow.

Filtrer les développeurs : Implémentez cette interface si vous écrivez un filtre qui génère des heures d’horloge fiables. Par exemple, les convertisseurs audio implémentent cette interface, car les cartes audio contiennent généralement une horloge de référence. Utilisez la classe CBaseReferenceClock pour implémenter cette interface.

Pour augmenter les chances qu’un filtre non-rendu soit sélectionné par le Gestionnaire de graphe de filtre comme la référence se ferme, procédez comme suit :

  1. Implémentez IReferenceClock dans le filtre.
  2. Implémentez IAMFilterMiscFlags dans le filtre.
  3. Retournez AM_FILTER_MISC_FLAGS_IS_SOURCE à partir de IAMFilterMiscFlags ::GetMiscFlags.
  4. Implémentez IAMPushSource sur toutes les broches de sortie.
  5. Retour (* pFlags) = 0 à partir de IAMPushSource ::GetPushSourceFlags.
  6. Vous pouvez retourner E_NOTIMPL de toutes les autres méthodes IAMPushSource .

Héritage

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

Méthodes

L’interface IReferenceClock possède ces méthodes.

 
IReferenceClock ::AdvisePeriodic

La méthode AdvisePeriodic crée une demande d’avis périodique.
IReferenceClock ::AdviseTime

La méthode AdviseTime crée une demande d’avis one-shot.
IReferenceClock ::GetTime

La méthode GetTime récupère l’heure de référence actuelle.
IReferenceClock ::Unadvise

La méthode Unadvise supprime une demande d’avis en attente.

Configuration requise

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