Método IMFMediaSink::SetPresentationClock (mfidl.h)

Define o relógio de apresentação no coletor de mídia.

Sintaxe

HRESULT SetPresentationClock(
  [in] IMFPresentationClock *pPresentationClock
);

Parâmetros

[in] pPresentationClock

Ponteiro para a interface IMFPresentationClock do relógio de apresentação ou NULL. Se o valor for NULL, o coletor de mídia deixará de ouvir o relógio de apresentação que foi definido anteriormente, se houver.

Valor retornado

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Comentários

Durante o streaming, o coletor de mídia tenta corresponder as taxas com o relógio da apresentação. O ideal é que o coletor de mídia apresente amostras no momento correto de acordo com o relógio da apresentação e não fique para trás. Coletores de mídia sem taxa são uma exceção a essa regra, pois consomem amostras o mais rápido possível e ignoram o relógio. Se o coletor for sem taxa, o método IMFMediaSink::GetCharacteristics retornará o sinalizador MEDIASINK_RATELESS.

O relógio de apresentação deve ter uma fonte de tempo. Antes de chamar esse método, chame IMFPresentationClock::SetTimeSource no relógio da apresentação para definir a origem da hora da apresentação. Alguns coletores de mídia fornecem fontes de tempo; portanto, o coletor de mídia pode ser a fonte de tempo para seu próprio relógio de apresentação. Independentemente de qual objeto fornece a fonte de tempo, no entanto, o coletor de mídia deve tentar corresponder as taxas com o relógio especificado em pPresentationClock. Se um coletor de mídia não puder corresponder as taxas com uma fonte de tempo externa, o método IMFMediaSink::GetCharacteristics do coletor de mídia recuperará o sinalizador MEDIASINK_CANNOT_MATCH_CLOCK. Nesse caso, SetPresentationClock ainda terá êxito, mas os resultados não serão ideais. O coletor pode não renderizar amostras rapidamente o suficiente para corresponder as taxas com o relógio de apresentação.

Se pPresentationClock não for NULL, o coletor de mídia deverá se registrar para notificações de estado do relógio, chamando IMFPresentationClock::AddClockStateSink no relógio da apresentação. Se o método for chamado novamente com um novo relógio de apresentação ou se pPresentationClock for NULL, o coletor de mídia deverá chamar IMFPresentationClock::RemoveClockStateSink para se desregistrar do relógio anterior.

Todos os coletores de mídia devem dar suporte a esse método.

Requisitos

Confira também

IMFMediaSink

Coletores de mídia

Relógio de Apresentação