Structure AVIFILEINFOW (vfw.h)

Article
08/27/2023

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

Syntaxe

typedef struct _AVIFILEINFOW {
  DWORD dwMaxBytesPerSec;
  DWORD dwFlags;
  DWORD dwCaps;
  DWORD dwStreams;
  DWORD dwSuggestedBufferSize;
  DWORD dwWidth;
  DWORD dwHeight;
  DWORD dwScale;
  DWORD dwRate;
  DWORD dwLength;
  DWORD dwEditCount;
  WCHAR szFileType[64];
} AVIFILEINFOW, *LPAVIFILEINFOW;

Membres

dwMaxBytesPerSec

Débit de données maximal approximatif du fichier AVI.

dwFlags

Or au niveau du bit de zéro ou plus d’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 segments dans le fichier. Utilisez l’index plutôt que l’ordre physique des segments lors de la lecture des données. Cela peut être utilisé pour créer une liste d’images à modifier.
AVIFILEINFO_ISINTERLEAVED	Le fichier AVI est entrelacé.
AVIFILEINFO_WASCAPTUREFILE	Le fichier AVI est un fichier spécialement alloué utilisé pour capturer des vidéos 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 le droit d’auteur. Lorsque cet indicateur est utilisé, le logiciel ne doit 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 une image 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 segment du fichier. Pour un fichier entrelacé, cette taille doit être suffisamment grande pour lire un enregistrement entier, pas seulement un segment.

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 pour l’ensemble du fichier. La division dwRate par dwScale donne le nombre d’échantillons par seconde.

N’importe quel 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 en échantillons par seconde, divisez cette valeur par la valeur dans dwScale.

dwLength

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

dwEditCount

Nombre de flux qui ont été 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

Notes

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

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]
En-tête	vfw.h

Voir aussi

Fonctions et macros AVIFile

AVIFile Structures

Partager via