Compartilhar via

Método IFilterGraph3::SetSyncSourceEx (strmif.h)

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O SetSyncSourceEx método estabelece dois relógios de referência para o grafo de filtro: um relógio primário usado pela maioria dos filtros e um relógio secundário que é usado apenas por um filtro especificado.

Sintaxe

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

Parâmetros

[in] pClockForMostOfFilterGraph

Ponteiro para a interface IReferenceClock do relógio de referência main. Cada filtro no grafo usa esse relógio, exceto o filtro especificado pelo parâmetro pFilter .

[in] pClockForFilter

Ponteiro para a interface IReferenceClock do relógio secundário. O filtro especificado pelo parâmetro pFilter usa esse relógio.

[in] pFilter

Ponteiro para a interface IBaseFilter de um filtro no grafo. Esse filtro usa o relógio de referência secundário.

Retornar valor

Retorna e o valor HRESULT . Os possíveis valores incluem os seguintes.

Código de retorno Descrição
S_OK
 Êxito.
VFW_E_NOT_STOPPED
 O grafo de filtro não é interrompido.

Comentários

Se o grafo de filtro estiver em execução ou em pausa, esse método retornará VFW_E_NOT_STOPPED.

Para limpar os dois relógios de referência, defina todos os três parâmetros como NULL. Para definir um único relógio para todo o grafo, sem relógio secundário, chame o método IMediaFilter::SetSyncSource no Gerenciador de Grafo de Filtro.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho strmif.h (inclua Dshow.h)
Biblioteca Strmiids.lib

Confira também

Códigos de erro e êxito

IFilterGraph3 Interface