Função MFFrameRateToAverageTimePerFrame (mfapi.h)

  • Artigo

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:

Quadros por segundo (ponto flutuante) Quadros por segundo (fracionário) Tempo médio por quadro
59.94 60000/1001 166833
29.97 30000/1001 333667
23.976 24000/1001 417188
60 60/1 166667
30 30/1 333333
50 50/1 200000
25 25/1 400000
24 24/1 416667
 

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

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mfapi.h
Biblioteca Mfplat.lib
DLL Mfplat.dll

Confira também

MFAverageTimePerFrameToFrameRate

Funções do Media Foundation

Tipos de mídia