AVIFileOpen, fonction (vfw.h)

  • Article

La fonction AVIFileOpen ouvre un fichier AVI et retourne l’adresse d’une interface de fichier utilisée pour y accéder. La bibliothèque AVIFile conserve le nombre de fois où un fichier est ouvert, mais pas le nombre de fois où il a été libéré. Utilisez la fonction AVIFileRelease pour libérer le fichier et décrémenter le nombre.

Syntaxe

HRESULT AVIFileOpen(
  PAVIFILE *ppfile,
  LPCSTR   szFile,
  UINT     uMode,
  LPCLSID  lpHandler
);

Paramètres

ppfile

Pointeur vers une mémoire tampon qui reçoit le nouveau pointeur d’interface IAVIFile .

szFile

Chaîne terminée par null contenant le nom du fichier à ouvrir.

uMode

Mode d’accès à utiliser lors de l’ouverture du fichier. Le mode d’accès par défaut est OF_READ. Les modes d’accès suivants peuvent être spécifiés avec AVIFileOpen.

Valeur Signification
OF_CREATE Crée un nouveau fichier. Si le fichier existe déjà, il est tronqué à la longueur nulle.
OF_PARSE Ignore les opérations fastidieuses, telles que la création d’un index. Définissez cet indicateur si vous souhaitez que la fonction retourne aussi rapidement que possible, par exemple, si vous voulez interroger les propriétés du fichier, mais pas lire le fichier.
OF_READ Ouvre le fichier pour lecture.
OF_READWRITE Ouvre le fichier pour la lecture et l’écriture.
OF_SHARE_DENY_NONE Ouvre le fichier de manière non exclusive. D’autres processus peuvent ouvrir le fichier avec un accès en lecture ou en écriture. AVIFileOpen échoue si un autre processus a ouvert le fichier en mode de compatibilité.
OF_SHARE_DENY_READ Ouvre le fichier de manière non exclusive. D’autres processus peuvent ouvrir le fichier avec un accès en écriture. AVIFileOpen échoue si un autre processus a ouvert le fichier en mode de compatibilité ou a accès en lecture à celui-ci.
OF_SHARE_DENY_WRITE Ouvre le fichier de manière non exclusive. D’autres processus peuvent ouvrir le fichier avec un accès en lecture. AVIFileOpen échoue si un autre processus a ouvert le fichier en mode de compatibilité ou a accès en écriture à celui-ci.
OF_SHARE_EXCLUSIVE Ouvre le fichier et refuse à d’autres processus tout accès à celui-ci. AVIFileOpen échoue si un autre processus a ouvert le fichier.
OF_WRITE Ouvre le fichier à écrire.

lpHandler

Pointeur vers un identificateur de classe du gestionnaire standard ou personnalisé que vous souhaitez utiliser. Si la valeur est NULL, le système choisit un gestionnaire dans le Registre en fonction de l’extension de fichier ou du type RIFF spécifié dans le fichier.

Valeur retournée

Retourne zéro en cas de réussite ou une erreur dans le cas contraire. Les valeurs d’erreur possibles sont les suivantes.

Code de retour Description
AVIERR_BADFORMAT
 Le fichier n’a pas pu être lu, ce qui indique un fichier endommagé ou un format non reconnu.
AVIERR_MEMORY
 Impossible d’ouvrir le fichier en raison d’une mémoire insuffisante.
AVIERR_FILEREAD
 Une erreur de disque s’est produite lors de la lecture du fichier.
AVIERR_FILEOPEN
 Une erreur de disque s’est produite lors de l’ouverture du fichier.
REGDB_E_CLASSNOTREG
 Selon le Registre, le type de fichier spécifié dans AVIFileOpen n’a pas de gestionnaire pour le traiter.

Configuration requise

   
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

AVIFileRelease