Método IFilterGraph3::SetSyncSourceEx (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.

El SetSyncSourceEx método establece dos relojes de referencia para el gráfico de filtros: un reloj principal que usa la mayoría de los filtros y un reloj secundario que solo usa un filtro especificado.

Sintaxis

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

Parámetros

[in] pClockForMostOfFilterGraph

Puntero a la interfaz IReferenceClock del reloj de referencia principal. Cada filtro del gráfico usa este reloj, excepto el filtro especificado por el parámetro pFilter .

[in] pClockForFilter

Puntero a la interfaz IReferenceClock del reloj secundario. El filtro especificado por el parámetro pFilter usa este reloj.

[in] pFilter

Puntero a la interfaz IBaseFilter de un filtro en el gráfico. Este filtro usa el reloj de referencia secundario.

Valor devuelto

Devuelve y valor HRESULT . Estos son algunos de los valores posibles.

Código devuelto	Descripción
S_OK	Correcto.
VFW_E_NOT_STOPPED	El gráfico de filtros no se detiene.

Comentarios

Si el gráfico de filtros se está ejecutando o en pausa, este método devuelve VFW_E_NOT_STOPPED.

Para borrar ambos relojes de referencia, establezca los tres parámetros en NULL. Para establecer un único reloj para todo el grafo, sin reloj secundario, llame al método IMediaFilter::SetSyncSource en el Administrador de gráficos de filtros.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	strmif.h (incluya Dshow.h)
Library	Strmiids.lib

Consulte también

Códigos de error y éxito

IFilterGraph3 (interfaz)