Méthode IMediaFilter::GetSyncSource (strmif.h)

Article
07/28/2023

[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 GetSyncSource méthode récupère l’horloge de référence actuelle.

Syntaxe

HRESULT GetSyncSource(
  [out] IReferenceClock **pClock
);

Paramètres

[out] pClock

Reçoit un pointeur vers l’interface IReferenceClock de l’horloge. L’appelant doit libérer l’interface.

Valeur renvoyée

Retourne une valeur HRESULT . Les valeurs possibles incluent celles indiquées dans le tableau suivant.

Code de retour	Description
S_OK	Succès
E_POINTER	Argument pointeur NULL

Notes

Cette méthode retourne la même horloge de référence que le dernier appel à IMediaFilter::SetSyncSource. S’il n’y a pas d’horloge de référence, pClock reçoit la valeur NULL. Lorsque la méthode retourne, si *pClock n’a pas la valeur NULL, l’interface IReferenceClock a un nombre de références en suspens. Veillez à le libérer lorsque vous avez terminé.

Vous pouvez également appeler cette méthode sur le Gestionnaire de graphes de filtre pour déterminer l’horloge de référence actuelle.

Configuration requise


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

Voir aussi

Codes d’erreur et de réussite

IMediaFilter Interface

Partager via