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:
| 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 |