Méthode IMFRateSupport::GetFastestRate (mfidl.h)
Obtient le taux de lecture le plus rapide pris en charge par l’objet.
Syntaxe
HRESULT GetFastestRate(
[in] MFRATE_DIRECTION eDirection,
[in] BOOL fThin,
[out] float *pflRate
);
Paramètres
[in] eDirection
Spécifie s’il faut interroger le taux de lecture de transfert le plus rapide ou le taux de lecture inversé. La valeur est membre de l’énumération MFRATE_DIRECTION .
[in] fThin
Si la valeur est TRUE, la méthode récupère le taux de lecture mince le plus rapide. Sinon, la méthode récupère le taux de lecture non mince le plus rapide. Pour plus d’informations sur l’amincissement, consultez À propos du contrôle de débit.
[out] pflRate
Reçoit le taux de lecture le plus rapide pris en charge par l’objet.
Valeur retournée
Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.
Code de retour | Description |
---|---|
|
S_OK |
|
L’objet ne prend pas en charge la lecture inversée. |
|
L’objet ne prend pas en charge l’amincissement. |
Notes
Pour certains formats (par exemple, ASF), l’amincissement signifie la suppression de toutes les images qui ne sont pas des images I. Si un composant produit des données de flux, telles qu’une source multimédia ou un démultiplexeur, il doit prêter attention au paramètre fThin et retourner MF_E_THINNING_UNSUPPORTED s’il ne peut pas éclaircir le flux.
Si le composant traite ou reçoit un flux (la plupart des transformations ou des récepteurs multimédias), il peut ignorer ce paramètre s’il ne se soucie pas de savoir si le flux est mince. Dans l’implémentation de la prise en charge des débits par la session multimédia, si les transformations ne prennent pas explicitement en charge la lecture inversée, la session multimédia tente de lire à l’envers avec un amincissement, mais non sans amincissement. Par conséquent, la plupart des applications définissent fThin sur TRUE lors de l’utilisation de la session multimédia pour la lecture inverse.
Si eDirection est MFRATE_REVERSE, la méthode récupère le taux de lecture inverse le plus rapide. Il s’agit d’une valeur négative, en supposant que l’objet prend en charge la lecture inversée.
Spécifications
Client minimal pris en charge | Windows Vista [applications de bureau | applications UWP] |
Serveur minimal pris en charge | Windows Server 2008 [applications de bureau | applications UWP] |
Plateforme cible | Windows |
En-tête | mfidl.h |
Bibliothèque | Mfuuid.lib |