AVISaveA, fonction (vfw.h)

  • Article

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

Voir aussi

Fonctions AVIFile

Fonctions et macros AVIFile