Método CRendererPosPassThru.RegisterMediaTime (Ctlutil.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 método RegisterMediaTime armazena em cache os carimbos de data/hora do exemplo atual.

Sintaxe

HRESULT RegisterMediaTime(
   IMediaSample *pMediaSample
);

Parâmetros

pMediaSample

Ponteiro para a interface IMediaSample do exemplo.

Retornar valor

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

Código de retorno Descrição
S_OK
 Êxito.
VFW_E_MEDIA_TIME_NOT_SET
 O exemplo não tem carimbo de data/hora.

Comentários

Esse método armazena os carimbos de data/hora do exemplo atual. O método CRendererPosPassThru::GetMediaTime recupera os mesmos valores.

O filtro deve chamar esse método para cada exemplo que ele recebe. O método é sobrecarregado para aceitar um ponteiro para o exemplo ou os próprios valores de carimbo de data/hora.

Requisitos

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