Método IMediaFilter::SetSyncSource (strmif.h)

Artigo
07/28/2023

[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 SetSyncSource método define o relógio de referência.

Sintaxe

HRESULT SetSyncSource(
  [in] IReferenceClock *pClock
);

Parâmetros

[in] pClock

Ponteiro para a interface IReferenceClock do relógio ou NULL. Se esse parâmetro for NULL, o grafo de filtro não usará um relógio de referência e todos os filtros serão executados o mais rápido possível.

Retornar valor

Retorna S_OK se tiver êxito ou um valor HRESULT que indica a causa do erro.

Comentários

Todos os filtros no grafo de filtro compartilham o mesmo relógio de referência para permanecer sincronizado. O tempo de fluxo é calculado a partir do relógio de referência. Os filtros de renderizador usam o relógio de referência para agendar quando renderizam amostras. Se não houver relógio de referência, um filtro de renderizador renderizará cada exemplo assim que ele chegar.

Esse método é implementado por todos os filtros directShow e também pelo Gerenciador de Grafo de Filtro.

Implementação de filtro

Quando o grafo é executado, o gerenciador do Filter Graph chama esse método em todos os filtros do grafo para notificá-los do relógio de referência do grafo. Use esse método para armazenar o ponteiro IReferenceClock . Incremente a contagem de referência no ponteiro armazenado. Antes que o filtro seja removido do grafo, o Gerenciador de Grafo de Filtro chama SetSyncSource novamente com o valor NULL. Solte o ponteiro armazenado e defina-o como NULL.

A classe CBaseFilter implementa esse método; consulte CBaseFilter::SetSyncSource.

Observe que os filtros não podem usar esse método para selecionar o relógio de grafo. Em filtros, a única função desse método é informar o filtro do relógio que o grafo está usando. Um filtro pode fornecer um relógio de referência expondo a interface IReferenceClock . Para obter mais informações, consulte Hora e relógios no DirectShow.

Uso do aplicativo

Um aplicativo pode substituir o relógio padrão chamando SetSyncSource no Gerenciador de Grafo de Filtro. Não faça isso a menos que você tenha um motivo específico para preferir outro relógio. Você também pode definir o grafo para não usar nenhum relógio de referência, chamando SetSyncSource com o valor NULL. Você pode fazer isso para processar amostras o mais rápido possível. Para obter mais informações, consulte Configurando o relógio do grafo.

Os aplicativos nunca devem chamar esse método em filtros.

Requisitos


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