IAsyncReader ::Length, méthode (strmif.h)
[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]
La Length méthode récupère la longueur totale du flux.
Syntaxe
HRESULT Length(
LONGLONG *pTotal,
LONGLONG *pAvailable
);
Paramètres
pTotal
Pointeur vers une variable qui reçoit la longueur du flux, en octets.
pAvailable
Pointeur vers une variable qui reçoit la partie du flux actuellement disponible, en octets.
Valeur retournée
Retourne une valeur HRESULT . Les valeurs possibles sont les suivantes.
| Code de retour | Description |
|---|---|
|
Réussite. |
|
Les valeurs retournées sont des estimations ; par exemple, si le fichier est en cours de lecture sur un réseau. |
|
Le fichier n’est pas ouvert ou n’existe plus. |
Remarques
Pour les flux récupérés sur un réseau, l’ensemble du flux peut ne pas être disponible au début. Les opérations de lecture au-delà de la longueur disponible peuvent bloquer pendant une longue période, jusqu’à ce que cette partie du flux devienne disponible.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | strmif.h (include Dshow.h) |
| Bibliothèque | Strmiids.lib |