Método CBaseRenderer.GetSampleTimes

  • 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 GetSampleTimes método recupera os carimbos de data/hora de um exemplo.

Sintaxe

virtual HRESULT GetSampleTimes(
   IMediaSample   *pMediaSample,
   REFERENCE_TIME *pStartTime,
   REFERENCE_TIME *pEndTime
);

Parâmetros

pMediaSample

Ponteiro para a interface IMediaSample do exemplo.

pStartTime

Ponteiro para uma variável que recebe a hora de início.

pEndTime

Ponteiro para uma variável que recebe a hora de término.

Retornar valor

Retorna um valor HRESULT . Os valores possíveis incluem os mostrados na tabela a seguir.

Código de retorno Descrição
S_OK
 O exemplo deve ser renderizado imediatamente.
S_FALSE
 O exemplo deve ser agendado para renderização, com base nos carimbos de data/hora.
E_FAIL
 Não renderize este exemplo.
VFW_E_START_TIME_AFTER_END
 Carimbo de data/hora inválido: a hora de término é anterior à hora de início.

Comentários

O filtro chama esse método para determinar como ele deve lidar com um exemplo. Se o valor retornado for S_OK, o filtro renderizará o exemplo imediatamente. Se o valor retornado for S_FALSE, o filtro agendará o exemplo para renderização, com base nos carimbos de data/hora. Se o valor retornado for um código de erro, o filtro rejeitará o exemplo.

Esse método retornará S_OK se o exemplo não tiver carimbos de data/hora ou se o filtro não tiver um relógio de referência. Caso contrário, ele retornará o valor do método CBaseRenderer::ShouldDrawSampleNow . Na classe base, ShouldDrawSampleNow sempre retorna S_FALSE. A classe derivada pode substituir esse comportamento. Por exemplo, se a classe derivada implementar o gerenciamento de controle de qualidade, ela poderá retornar E_FAIL para remover um exemplo.

Requisitos

Requisito Valor
parâmetro
Renbase.h (inclua Streams.h)
Biblioteca
Strmbase.lib (builds de varejo);
Strmbasd.lib (builds de depuração)

Confira também

Classe CBaseRenderer