Structure AVIFILEINFOA (vfw.h)

Article
11/20/2024

La structure AVIFILEINFO contient des informations globales pour un fichier AVI entier.

Syntaxe

typedef struct _AVIFILEINFOA {
  DWORD dwMaxBytesPerSec;
  DWORD dwFlags;
  DWORD dwCaps;
  DWORD dwStreams;
  DWORD dwSuggestedBufferSize;
  DWORD dwWidth;
  DWORD dwHeight;
  DWORD dwScale;
  DWORD dwRate;
  DWORD dwLength;
  DWORD dwEditCount;
  char  szFileType[64];
} AVIFILEINFOA, *LPAVIFILEINFOA;

Membres

dwMaxBytesPerSec

Taux de données maximal approximatif du fichier AVI.

dwFlags

Au niveau du bit, OU de zéro ou plusieurs indicateurs. Les indicateurs suivants sont définis :

Nom	Description
AVIFILEINFO_HASINDEX	Le fichier AVI a un index à la fin du fichier. Pour de bonnes performances, tous les fichiers AVI doivent contenir un index.
AVIFILEINFO_MUSTUSEINDEX	L’index de fichier contient l’ordre de lecture des blocs du fichier. Utilisez l’index plutôt que l’ordre physique des blocs lors de la lecture des données. Cela peut être utilisé pour créer une liste de cadres pour la modification.
AVIFILEINFO_ISINTERLEAVED	Le fichier AVI est entrelacé.
AVIFILEINFO_WASCAPTUREFILE	Le fichier AVI est un fichier spécialement alloué utilisé pour capturer une vidéo en temps réel. Les applications doivent avertir l’utilisateur avant d’écrire sur un fichier avec cet indicateur défini, car l’utilisateur a probablement défragmenté ce fichier.
AVIFILEINFO_COPYRIGHTED	Le fichier AVI contient des données et des logiciels protégés par copyright. Lorsque cet indicateur est utilisé, les logiciels ne doivent pas autoriser les données à être dupliquées.

dwCaps

Indicateurs de capacité. Les indicateurs suivants sont définis :

Nom	Description
AVIFILECAPS_CANREAD	Une application peut ouvrir le fichier AVI avec le privilège de lecture.
AVIFILECAPS_CANWRITE	Une application peut ouvrir le fichier AVI avec le privilège d’écriture.
AVIFILECAPS_ALLKEYFRAMES	Chaque image du fichier AVI est un cadre clé.
AVIFILECAPS_NOCOMPRESSION	Le fichier AVI n’utilise pas de méthode de compression.

dwStreams

Nombre de flux dans le fichier. Par exemple, un fichier avec audio et vidéo a au moins deux flux.

dwSuggestedBufferSize

Taille de mémoire tampon suggérée, en octets, pour la lecture du fichier. En règle générale, cette taille doit être suffisamment grande pour contenir le plus grand bloc dans le fichier. Pour un fichier entrelacé, cette taille doit être suffisamment grande pour lire un enregistrement entier, pas seulement un bloc.

Si la taille de la mémoire tampon est trop petite ou est définie sur zéro, le logiciel de lecture doit réallouer la mémoire pendant la lecture, ce qui réduit les performances.

dwWidth

Largeur, en pixels, du fichier AVI.

dwHeight

Hauteur, en pixels, du fichier AVI.

dwScale

Échelle de temps applicable à l’ensemble du fichier. La division dwRate par dwScale donne le nombre d’échantillons par seconde.

Tout flux peut définir sa propre échelle de temps pour remplacer l’échelle de temps de fichier.

dwRate

Taux dans un format entier. Pour obtenir le taux dans les échantillons par seconde, divisez cette valeur par la valeur de dwScale.

dwLength

Longueur du fichier AVI. Les unités sont définies par dwRate et dwScale.

dwEditCount

Nombre de flux ajoutés ou supprimés du fichier AVI.

szFileType[64]

Chaîne terminée par null contenant des informations descriptives pour le type de fichier.

Remarques

Note

L’en-tête vfw.h définit AVIFILEINFO 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]
d’en-tête	vfw.h

Voir aussi

fonctions et macros AVIFile

structures AVIFile

Partager via