AVIFileOpenA, fonction (vfw.h)
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 qu’il a été libéré. Utilisez la fonction AVIFileRelease pour libérer le fichier et décrémenter le nombre.
Syntaxe
HRESULT AVIFileOpenA(
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 fichier. Si le fichier existe déjà, il est tronqué à zéro longueur. |
| 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 le plus rapidement possible, par exemple si vous allez interroger les propriétés du fichier, mais pas lire le fichier. |
| OF_READ | Ouvre le fichier à lire. |
| OF_READWRITE | Ouvre le fichier pour la lecture et l’écriture. |
| OF_SHARE_DENY_NONE | Ouvre le fichier de manière non cluster. 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 cluster. 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 y a accès en lecture. |
| OF_SHARE_DENY_WRITE | Ouvre le fichier de manière non cluster. 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 y a accès en écriture. |
| 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 pour l’écriture. |
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 à partir du Registre en fonction de l’extension de fichier ou du type RIFF spécifié dans le fichier.
Valeur de retour
Retourne zéro en cas de réussite ou d’erreur dans le cas contraire. Les valeurs d’erreur possibles sont les suivantes.
| Retourner le code | Description |
|---|---|
|
Le fichier n’a pas pu être lu, indiquant un fichier endommagé ou un format non reconnu. |
|
Impossible d’ouvrir le fichier en raison d’une mémoire insuffisante. |
|
Une erreur de disque s’est produite lors de la lecture du fichier. |
|
Une erreur de disque s’est produite lors de l’ouverture du fichier. |
|
Selon le Registre, le type de fichier spécifié dans AVIFileOpen ne dispose pas d’un gestionnaire pour le traiter. |
Remarques
Note
L’en-tête vfw.h définit AVIFileOpen 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] |
| plateforme cible | Windows |
| d’en-tête | vfw.h |
| bibliothèque | Vfw32.lib |
| DLL | Avifil32.dll |