Metodo IFilterGraph3::SetSyncSourceEx (strmif.h)

Articolo
03/02/2024

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il SetSyncSourceEx metodo stabilisce due orologi di riferimento per il grafico del filtro: un orologio primario utilizzato dalla maggior parte dei filtri e un orologio secondario usato solo da un filtro specificato.

Sintassi

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

Parametri

[in] pClockForMostOfFilterGraph

Puntatore all'interfaccia IReferenceClock dell'orologio di riferimento principale. Ogni filtro nel grafico usa questo orologio, ad eccezione del filtro specificato dal parametro pFilter .

[in] pClockForFilter

Puntatore all'interfaccia IReferenceClock dell'orologio secondario. Il filtro specificato dal parametro pFilter usa questo orologio.

[in] pFilter

Puntatore all'interfaccia IBaseFilter di un filtro nel grafico. Questo filtro usa l'orologio di riferimento secondario.

Valore restituito

Restituisce e valore HRESULT . Di seguito sono indicati alcuni valori possibili.

Codice restituito	Descrizione
S_OK	Operazione completata.
VFW_E_NOT_STOPPED	Il grafico del filtro non viene arrestato.

Commenti

Se il grafico del filtro è in esecuzione o sospeso, questo metodo restituisce VFW_E_NOT_STOPPED.

Per cancellare entrambi gli orologi di riferimento, impostare tutti e tre i parametri su NULL. Per impostare un singolo orologio per l'intero grafico, senza orologio secondario, chiamare il metodo IMediaFilter::SetSyncSource in Filter Graph Manager.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	strmif.h (include Dshow.h)
Libreria	Strmiids.lib

Vedi anche

Codici errore e esito positivo

Interfaccia IFilterGraph3

Condividi tramite