Método CSourceSeeking.ConvertTimeFormat

  • 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 ConvertTimeFormat método converte de um formato de vez em outro. Esse método implementa o método IMediaSeeking::ConvertTimeFormat .

Sintaxe

HRESULT ConvertTimeFormat(
         LONGLONG *pTarget,
   const GUID     *pTargetFormat,
         LONGLONG Source,
   const GUID     *pSourceFormat
);

Parâmetros

pTarget

Ponteiro para uma variável que recebe o tempo convertido.

pTargetFormat

Ponteiro para o GUID do formato de destino. Se NULL, o formato atual será usado. Consulte GUIDs de formato de tempo.

Origem

Valor de tempo a ser convertido.

pSourceFormat

Ponteiro para o GUID de formato de hora do formato a ser convertido. Se NULL, o formato atual será usado.

Retornar valor

Retorna um dos valores HRESULT listados na tabela a seguir.

Código de retorno Descrição
S_OK
 Êxito
E_INVALIDARG
 Argumento inválido
E_POINTER
 Argumento de ponteiro NULL

Comentários

O único formato de tempo compatível com a classe base é TIME_FORMAT_MEDIA_TIME (unidades de 100 nanossegundos). Esse método retorna E_INVALIDARG, exceto no caso trivial em que pTargetFormat e pSourceFormat especificam TIME_FORMAT_MEDIA_TIME.

Requisitos

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

Confira também

Classe CSourceSeeking