FONCTION AVIStreamRead (vfw.h)

Article
03/03/2024

La fonction AVIStreamRead lit des données audio, vidéo ou autres à partir d’un flux en fonction du type de flux.

Syntaxe

HRESULT AVIStreamRead(
  PAVISTREAM pavi,
  LONG       lStart,
  LONG       lSamples,
  LPVOID     lpBuffer,
  LONG       cbBuffer,
  LONG       *plBytes,
  LONG       *plSamples
);

Paramètres

pavi

Gérer vers un flux ouvert.

lStart

Premier exemple à lire.

lSamples

Nombre d’exemples à lire. Vous pouvez également spécifier la valeur AVISTREAMREAD_CONVENIENT pour permettre au gestionnaire de flux de déterminer le nombre d’exemples à lire.

lpBuffer

Pointeur vers une mémoire tampon pour contenir les données.

cbBuffer

Taille, en octets, de la mémoire tampon pointée par lpBuffer.

plBytes

Pointeur vers une mémoire tampon qui reçoit le nombre d’octets de données écrites dans la mémoire tampon référencée par lpBuffer. Cette valeur peut être NULL.

plSamples

Pointeur vers une mémoire tampon qui reçoit le nombre d’exemples écrits dans la mémoire tampon référencée par lpBuffer. Cette valeur peut être NULL.

Valeur retournée

Retourne zéro en cas de réussite ou une erreur dans le cas contraire. Les valeurs d’erreur possibles sont les suivantes.

Code de retour	Description
AVIERR_BUFFERTOOSMALL	La taille de la mémoire tampon cbBuffer était inférieure à celle d’un seul échantillon de données.
AVIERR_MEMORY	La mémoire était insuffisante pour terminer l’opération de lecture.
AVIERR_FILEREAD	Une erreur de disque s’est produite lors de la lecture du fichier.

Remarques

Si lpBuffer a la valeur NULL, cette fonction ne lit aucune donnée ; elle retourne des informations sur la taille des données qui seraient lues.

L’argument pavi est un pointeur vers une interface IAVIStream.

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	vfw.h
Bibliothèque	Vfw32.lib
DLL	Avifil32.dll

Voir aussi

Fonctions AVIFile

Fonctions et macros AVIFile

Partager via