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