Função MFFrameRateToAverageTimePerFrame (mfapi.h)

Converte uma taxa de quadros de vídeo em uma duração de quadro.

Sintaxe

HRESULT MFFrameRateToAverageTimePerFrame(
  [in]  UINT32 unNumerator,
  [in]  UINT32 unDenominator,
  [out] UINT64 *punAverageTimePerFrame
);

Parâmetros

[in] unNumerator

O numerador da taxa de quadros.

[in] unDenominator

O denominador da taxa de quadros.

[out] punAverageTimePerFrame

Recebe a duração média de um quadro de vídeo, em unidades de 100 nanossegundos.

Valor retornado

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Essa função é útil para calcular carimbos de data/hora em um exemplo, dada a taxa de quadros.

Além disso, o tempo médio por quadro é usado nas estruturas de formato VIDEOINFOHEADER e VIDEOINFOHEADER2 mais antigas. Essa função fornece uma conversão padrão para que todos os componentes no pipeline possam usar valores consistentes, se precisarem traduzir entre as estruturas de formato mais antigas e os atributos de tipo de mídia usados no Media Foundation.

Para determinadas taxas de quadros comuns, a função obtém a duração do quadro de uma tabela de pesquisa:

A maioria dos conteúdos de vídeo usa uma das taxas de quadros listadas aqui. Para outras taxas de quadro, a função calcula a duração.

Requisitos

Confira também

MFAverageTimePerFrameToFrameRate

Funções do Media Foundation

Tipos de mídia