Fonction MFFrameRateToAverageTimePerFrame (mfapi.h)
Convertit une fréquence d’images vidéo en durée d’images.
Syntaxe
HRESULT MFFrameRateToAverageTimePerFrame(
[in] UINT32 unNumerator,
[in] UINT32 unDenominator,
[out] UINT64 *punAverageTimePerFrame
);
Paramètres
[in] unNumerator
Numérateur de la fréquence d’images.
[in] unDenominator
Dénominateur de la fréquence d’images.
[out] punAverageTimePerFrame
Reçoit la durée moyenne d’une image vidéo, en unités de 100 nanosecondes.
Valeur retournée
Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Notes
Cette fonction est utile pour calculer les horodatages sur un échantillon, compte tenu de la fréquence d’images.
En outre, la durée moyenne par image est utilisée dans les anciennes structures de format VIDEOINFOHEADER et VIDEOINFOHEADER2 . Cette fonction fournit une conversion standard afin que tous les composants du pipeline puissent utiliser des valeurs cohérentes, s’ils doivent traduire entre les anciennes structures de format et les attributs de type de média utilisés dans Media Foundation.
Pour certaines fréquences d’images courantes, la fonction obtient la durée des images à partir d’une table de recherche :
| Images par seconde (virgule flottante) | Images par seconde (fractionnaires) | Temps moyen par image |
|---|---|---|
| 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 |
La plupart du contenu vidéo utilise l’une des fréquences d’images répertoriées ici. Pour les autres fréquences d’images, la fonction calcule la durée.
Spécifications
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | mfapi.h |
| Bibliothèque | Mfplat.lib |
| DLL | Mfplat.dll |