IFilterGraph3 ::SetSyncSourceEx, méthode (strmif.h)

Article
03/02/2024

[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.]

La SetSyncSourceEx méthode établit deux horloges de référence pour le graphe de filtre : une horloge primaire utilisée par la plupart des filtres et une horloge secondaire utilisée uniquement par un filtre spécifié.

Syntaxe

HRESULT SetSyncSourceEx(
  [in] IReferenceClock *pClockForMostOfFilterGraph,
  [in] IReferenceClock *pClockForFilter,
  [in] IBaseFilter     *pFilter
);

Paramètres

[in] pClockForMostOfFilterGraph

Pointeur vers l’interface IReferenceClock de l’horloge de référence main. Chaque filtre du graphique utilise cette horloge, à l’exception du filtre spécifié par le paramètre pFilter .

[in] pClockForFilter

Pointeur vers l’interface IReferenceClock de l’horloge secondaire. Le filtre spécifié par le paramètre pFilter utilise cette horloge.

[in] pFilter

Pointeur vers l’interface IBaseFilter d’un filtre dans le graphique. Ce filtre utilise l’horloge de référence secondaire.

Valeur retournée

Retourne et la valeur HRESULT . Les valeurs possibles sont les suivantes.

Code de retour	Description
S_OK	Réussite.
VFW_E_NOT_STOPPED	Le graphe de filtre n’est pas arrêté.

Remarques

Si le graphe de filtre est en cours d’exécution ou en pause, cette méthode retourne VFW_E_NOT_STOPPED.

Pour effacer les deux horloges de référence, définissez les trois paramètres sur NULL. Pour définir une seule horloge pour l’ensemble du graphe, sans horloge secondaire, appelez la méthode IMediaFilter ::SetSyncSource sur le Gestionnaire de graphes de filtre.

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

IFilterGraph3 Interface

Partager via