Partager via


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
S_OK
Réussite.
VFW_S_ESTIMATED
Les valeurs retournées sont des estimations ; par exemple, si le fichier est en cours de lecture sur un réseau.
E_UNEXPECTED
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

Voir aussi

Codes d’erreur et de réussite

IAsyncReader Interface