AVIStreamOpenFromFileA, fonction (vfw.h)

La fonction AVIStreamOpenFromFile ouvre un seul flux à partir d’un fichier.

Syntaxe

HRESULT AVIStreamOpenFromFileA(
  PAVISTREAM *ppavi,
  LPCSTR     szFile,
  DWORD      fccType,
  LONG       lParam,
  UINT       mode,
  CLSID      *pclsidHandler
);

Paramètres

ppavi

Pointeur vers une mémoire tampon qui reçoit le nouveau handle de flux.

szFile

Chaîne terminée par null contenant le nom du fichier à ouvrir.

fccType

Code à quatre caractères indiquant le type de flux à ouvrir. Zéro indique que n’importe quel flux peut être ouvert. Les définitions suivantes s’appliquent aux données couramment trouvées dans les flux AVI :

Valeur	Description
streamtypeAUDIO	Indique un flux audio.
streamtypeMIDI	Indique un flux MIDI.
streamtypeTEXT	Indique un flux de texte.
streamtypeVIDEO	Indique un flux vidéo.

lParam

Stream du type spécifié dans fccType à accéder. Ce paramètre est de base zéro ; utilisez zéro pour spécifier la première occurrence.

mode

Mode d’accès à utiliser lors de l’ouverture du fichier. Cette fonction ne peut ouvrir que des flux existants, de sorte que l’indicateur de mode OF_CREATE ne peut pas être utilisé. Pour plus d’informations sur les indicateurs disponibles pour le paramètre mode , consultez la fonction OpenFile .

pclsidHandler

Pointeur vers un identificateur de classe du gestionnaire que vous souhaitez utiliser. Si la valeur est NULL, le système en choisit un dans le Registre en fonction de l’extension de fichier ou du type RIFF de fichier.

Valeur retournée

Retourne zéro en cas de réussite ou une erreur dans le cas contraire.

Remarques

Cette fonction appelle les fonctions AVIFileOpen, AVIFileGetStream et AVIFileRelease .

Notes

L’en-tête vfw.h définit AVIStreamOpenFromFile comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

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