Metodo IFilterGraph::SetDefaultSyncSource (strmif.h)

[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 SetDefaultSyncSource metodo imposta l'orologio di riferimento sull'orologio predefinito.

Sintassi

HRESULT SetDefaultSyncSource();

Valore restituito

Restituisce un valore HRESULT . I possibili valori sono i seguenti:

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

Commenti

Questo metodo indica a Filter Graph Manager di scegliere un orologio di riferimento usando il relativo algoritmo predefinito. Per altre informazioni sull'algoritmo usato, vedere Orologi di riferimento.

In genere non è necessario chiamare questo metodo, perché Filter Graph Manager seleziona automaticamente un orologio. Tuttavia, se si chiama IMediaFilter::SetSyncSource per eseguire l'override dell'orologio, è possibile usare SetDefaultSyncSource per ripristinare l'orologio predefinito.

Questo metodo ha esito negativo se il grafico del filtro è in esecuzione o sospeso.

Requisiti

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

Vedi anche

Codici errore e esito positivo

Interfaccia IFilterGraph

Ora e orologi in DirectShow