AVIFileOpen, 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 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 |
|---|---|
|
Le fichier n’a pas pu être lu, ce qui indique 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 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 |