Méthode IAVIStream ::ReadFormat (vfw.h)

La méthode ReadFormat obtient des informations de format à partir d’un flux. Remplit et retourne une structure avec les données dans une mémoire tampon définie par l’application. Si aucune mémoire tampon n’est fournie, détermine la taille de la mémoire tampon nécessaire pour récupérer la mémoire tampon des données de format. Appelé lorsqu’une application utilise la fonction AVIStreamReadFormat .

Syntaxe

HRESULT ReadFormat(
  LONG   lPos,
  LPVOID lpFormat,
  LONG   *lpcbFormat
);

Paramètres

lPos

Position de l’échantillon ou du frame.

lpFormat

Pointeur vers la mémoire tampon pour les données de format. Spécifiez NULL pour demander la taille requise de la mémoire tampon.

lpcbFormat

Pointeur vers une mémoire tampon qui reçoit la taille, en octets, de la mémoire tampon spécifiée par lpFormat. Lorsque cette méthode est appelée, le contenu de ce paramètre indique la taille de la mémoire tampon spécifiée par lpFormat. Lorsque cette méthode retourne le contrôle à l’application, le contenu de ce paramètre spécifie la quantité de données lues ou la taille requise de la mémoire tampon.

Valeur retournée

Retourne le HRESULT défini par OLE.

Remarques

Le type de données stockées dans un flux détermine les informations de format et la structure qui contient les informations de format. Un gestionnaire de flux doit retourner toutes les informations de format applicables dans cette structure, y compris les informations de palette lorsque le format utilise une palette. Un gestionnaire de flux ne doit pas retourner de données de flux avec la structure .

Les gestionnaires de flux vidéo standard fournissent des informations de format dans une structure BITMAPINFOHEADER . Les gestionnaires de flux audio standard fournissent des informations de format dans une structure PCMWAVEFORMAT . D’autres flux de données peuvent utiliser d’autres structures qui décrivent les données de flux.

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

HRESULT ReadFormat(LONG lPos, LPVOID lpFormat, 
    LONG *lpcbFormat) 
 

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

Voir aussi

Interfaces de gestionnaire de fichiers et de Stream personnalisées

Gestionnaires de fichiers et de Stream personnalisés