Méthode IMFRateSupport::GetFastestRate (mfidl.h)

  • Article

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
 S_OK
MF_E_REVERSE_UNSUPPORTED
 L’objet ne prend pas en charge la lecture inversée.
MF_E_THINNING_UNSUPPORTED
 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

Voir aussi

Guide pratique pour déterminer les taux pris en charge

IMFRateSupport