Interfaz IReferenceClock (strmif.h)

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

La IReferenceClock interfaz proporciona la hora de referencia para el gráfico de filtros.

Los filtros que pueden actuar como un reloj de referencia pueden exponer esta interfaz. También lo expone el reloj de referencia del sistema. El administrador de gráficos de filtros usa esta interfaz para sincronizar el gráfico de filtros. Las aplicaciones pueden usar esta interfaz para recuperar la hora de referencia actual o para solicitar una notificación de un tiempo transcurrido.

Para obtener más información, vea Hora y relojes en DirectShow.

Filtrar desarrolladores: Implemente esta interfaz si está escribiendo un filtro que genera tiempos de reloj confiables. Por ejemplo, los representadores de audio implementan esta interfaz, ya que las placas de sonido de audio normalmente contienen un reloj de referencia. Use la clase CBaseReferenceClock para implementar esta interfaz.

Para aumentar las posibilidades de que el Administrador de gráficos de filtros seleccione un filtro que no sea de representación como cierre de referencia, siga estos pasos:

1. Implemente IReferenceClock en el filtro.
2. Implemente IAMFilterMiscFlags en el filtro.
3. Devuelve AM_FILTER_MISC_FLAGS_IS_SOURCE desde IAMFilterMiscFlags::GetMiscFlags.
4. Implemente IAMPushSource en todos los pines de salida.
5. Return (* pFlags) = 0 de IAMPushSource::GetPushSourceFlags.
6. Puede devolver E_NOTIMPL de todos los demás métodos IAMPushSource .

Herencia

La interfaz IReferenceClock hereda de la interfaz IUnknown . IReferenceClock también tiene estos tipos de miembros:

Métodos

La interfaz IReferenceClock tiene estos métodos.

IReferenceClock::AdvisePeriodic El método AdvisePeriodic crea una solicitud de aviso periódica.
IReferenceClock::AdviseTime El método AdviseTime crea una solicitud de aviso único.
IReferenceClock::GetTime El método GetTime recupera la hora de referencia actual.
IReferenceClock::Unadvise El método Unadvise quita una solicitud de aviso pendiente.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	strmif.h (incluya Dshow.h)