AVISaveA, fonction (vfw.h)
La fonction AVISave génère un fichier en combinant des flux de données à partir d’autres fichiers ou de la mémoire.
Syntaxe
HRESULT AVISaveA(
LPCSTR szFile,
CLSID *pclsidHandler,
AVISAVECALLBACK lpfnCallback,
int nStreams,
PAVISTREAM pfile,
LPAVICOMPRESSOPTIONS lpOptions,
...
);
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 pour l’opération d’enregistrement.
nStreams
Nombre de flux enregistrés dans le fichier.
pfile
Pointeur vers un flux AVI. Ce paramètre est associé à lpOptions. La paire de paramètres peut être répétée sous la forme d’un nombre variable d’arguments.
lpOptions
Pointeur vers une structure AVICOMPRESSOPTIONS définie par l’application contenant les options de compression pour le flux référencé par pavi. Ce paramètre est associé à pavi. La paire de paramètres peut être répétée sous la forme d’un nombre variable d’arguments.
...
Valeur retournée
Retourne AVIERR_OK en cas de réussite ou une erreur dans le cas contraire.
Remarques
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 identifient un flux à enregistrer dans le fichier et définissent les options de compression de ce flux. Lors de l’enregistrement de plusieurs flux dans un fichier AVI, répétez ces deux paramètres spécifiques au flux pour chaque flux du fichier.
Une fonction de rappel (référencée à l’aide de lpfnCallback) peut afficher status informations et permettre à l’utilisateur d’annuler l’opération d’enregistrement. La fonction de rappel utilise le format suivant :
LONG PASCAL SaveCallback(int nPercent)
Le paramètre nPercent spécifie le pourcentage du fichier enregistré.
La fonction de rappel doit retourner AVIERR_OK si l’opération doit continuer et AVIERR_USERABORT si l’utilisateur souhaite abandonner l’opération d’enregistrement.
L’argument pavi est un pointeur vers une interface IAVIStream.
Notes
L’en-tête vfw.h définit AVISave en tant qu’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 |