IAVIStream::Read, méthode (vfw.h)

Article
08/27/2023

La méthode Read lit les données d’un flux et les copie dans une mémoire tampon définie par l’application. Si aucune mémoire tampon n’est fournie, elle détermine la taille de la mémoire tampon nécessaire pour récupérer la mémoire tampon de données suivante. Appelé lorsqu’une application utilise la fonction AVIStreamRead .

Syntaxe

HRESULT Read(
  LONG   lStart,
  LONG   lSamples,
  LPVOID lpBuffer,
  LONG   cbBuffer,
  LONG   *plBytes,
  LONG   *plSamples
);

Paramètres

lStart

Démarrage de l’exemple ou du numéro de trame à lire.

lSamples

Nombre d’exemples à lire.

lpBuffer

Pointeur vers la mémoire tampon définie par l’application pour contenir les données de flux. Vous pouvez également spécifier NULL pour demander la taille requise de la mémoire tampon. De nombreuses applications précèdent chaque opération de lecture avec une requête de taille de mémoire tampon pour voir la taille d’une mémoire tampon nécessaire.

cbBuffer

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

plBytes

Pointeur vers une mémoire tampon qui reçoit le nombre d’octets lus.

plSamples

Pointeur vers une mémoire tampon qui reçoit le nombre d’exemples lus.

Valeur retournée

Retourne AVIERR_OK en cas de réussite ou AVIERR_BUFFERTOOSMALL si la mémoire tampon n’est pas suffisamment grande pour contenir les données. En cas de réussite, La lecture renvoie également une mémoire tampon de données avec le nombre de trames (exemples) incluses dans la mémoire tampon ou la taille de mémoire tampon requise, en octets.

Remarques

Pour les gestionnaires écrits en C++, Read a la syntaxe suivante :


HRESULT Read(LONG lStart, LONG lSamples, 
    LPVOID lpBuffer, LONG cbBuffer, 
    LONG *plBytes, LONG *plSamples);

Configuration requise


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

Voir aussi

Interfaces de gestionnaire de fichiers et de flux personnalisés

Gestionnaires de fichiers et de flux personnalisés

Partager via