AVISaveVA, fonction (vfw.h)
La fonction AVISaveV génère un fichier en combinant des flux de données à partir d’autres fichiers ou à partir de la mémoire.
Syntaxe
HRESULT AVISaveVA(
LPCSTR szFile,
CLSID *pclsidHandler,
AVISAVECALLBACK lpfnCallback,
int nStreams,
PAVISTREAM *ppavi,
LPAVICOMPRESSOPTIONS *plpOptions
);
Paramètres
szFile
Chaîne terminée par null contenant le nom du fichier à enregistrer.
pclsidHandler
Pointeur vers le gestionnaire de fichiers utilisé pour écrire le fichier. Le fichier est créé en appelant la fonction AVIFileOpen à l’aide de ce gestionnaire. Si aucun gestionnaire n’est spécifié, une valeur par défaut est sélectionnée dans le Registre en fonction de l’extension de fichier.
lpfnCallback
Pointeur vers une fonction de rappel utilisée pour afficher les informations d’état et permettre à l’utilisateur d’annuler l’opération d’enregistrement.
nStreams
Nombre de flux à enregistrer.
ppavi
Pointeur vers un tableau de pointeurs vers les structures de fonction AVISTREAM. Le tableau utilise un pointeur pour chaque flux.
plpOptions
Pointeur vers un tableau de pointeurs vers structures AVICOMPRESSOPTIONS. Le tableau utilise un pointeur pour chaque flux.
Valeur de retour
Retourne AVIERR_OK en cas de réussite ou d’erreur dans le cas contraire.
Remarques
Cette fonction équivaut à la fonction AVISave, sauf que les flux sont passés dans un tableau au lieu d’un nombre variable d’arguments.
Cette fonction crée un fichier, copie les données de flux dans le fichier, ferme le fichier et libère les ressources utilisées par le nouveau fichier. Les deux derniers paramètres de cette fonction sont des tableaux qui identifient les flux à enregistrer dans le fichier et définissent les options de compression de ces flux.
Une application doit allouer de la mémoire pour les structures AVICOMPRESSOPTIONS et le tableau de pointeurs vers ces structures.
L’argument ppavi contient l’adresse d’un pointeur vers une interface IAVIStream.
Note
L’en-tête vfw.h définit AVISaveV 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. Le mélange 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | vfw.h |
| bibliothèque | Vfw32.lib |
| DLL | Avifil32.dll |