Interfaccia IReferenceClock (strmif.h)

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine 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, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

L'interfaccia IReferenceClock fornisce il tempo di riferimento per il grafico dei filtri.

I filtri che possono fungere da orologio di riferimento possono esporre questa interfaccia. Viene esposto anche dall'orologio di riferimento di sistema. Gestione grafici filtri usa questa interfaccia per sincronizzare il grafico dei filtri. Le applicazioni possono usare questa interfaccia per recuperare il tempo di riferimento corrente o per richiedere la notifica di un tempo trascorso.

Per altre informazioni, vedere Time and Clocks in DirectShow.

Filtrare gli sviluppatori: Implementare questa interfaccia se si sta scrivendo un filtro che genera orari di clock affidabili. Ad esempio, i renderer audio implementano questa interfaccia, perché le schede audio in genere contengono un orologio di riferimento. Usare la classe CBaseReferenceClock per implementare questa interfaccia.

Per aumentare le probabilità che un filtro non di rendering venga selezionato da Filter Graph Manager come chiusura del riferimento, seguire questa procedura:

1. Implementare IReferenceClock nel filtro.
2. Implementare IAMFilterMiscFlags nel filtro.
3. Restituire AM_FILTER_MISC_FLAGS_IS_SOURCE da IAMFilterMiscFlags::GetMiscFlags.
4. Implementare IAMPushSource in tutti i pin di output.
5. Return (* pFlags) = 0 da IAMPushSource::GetPushSourceFlags.
6. È possibile restituire E_NOTIMPL da tutti gli altri metodi IAMPushSource .

Ereditarietà

L'interfaccia IReferenceClock eredita dall'interfaccia IUnknown . IReferenceClock include anche questi tipi di membri:

Metodi

L'interfaccia IReferenceClock include questi metodi.

IReferenceClock::AdvisePeriodic Il metodo AdvisePeriodic crea una richiesta di consulenza periodica.
IReferenceClock::AdviseTime Il metodo AdviseTime crea una richiesta di consulenza singola.
IReferenceClock::GetTime Il metodo GetTime recupera l'ora di riferimento corrente.
IReferenceClock::Unadvise Il metodo Unadvise rimuove una richiesta di avviso in sospeso.

Requisiti

Requisito	Valore
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)