AVIFileOpen-Funktion (vfw.h)
Die FUNKTION AVIFileOpen öffnet eine AVI-Datei und gibt die Adresse einer Dateischnittstelle zurück, die für den Zugriff verwendet wird. Die AVIFile-Bibliothek verwaltet die Anzahl der Öffnungen einer Datei, aber nicht die Anzahl der Freigaben. Verwenden Sie die AVIFileRelease-Funktion , um die Datei freizugeben und die Anzahl zu verringern.
Syntax
HRESULT AVIFileOpen(
PAVIFILE *ppfile,
LPCSTR szFile,
UINT uMode,
LPCLSID lpHandler
);
Parameter
ppfile
Zeiger auf einen Puffer, der den neuen IAVIFile-Schnittstellenzeiger empfängt.
szFile
Null-beendete Zeichenfolge, die den Namen der zu öffnenden Datei enthält.
uMode
Zugriffsmodus, der beim Öffnen der Datei verwendet werden soll. Der Standardzugriffsmodus ist OF_READ. Die folgenden Zugriffsmodi können mit AVIFileOpen angegeben werden.
| Wert | Bedeutung |
|---|---|
| OF_CREATE | Erstellt eine neue Datei. Wenn die Datei bereits vorhanden ist, wird sie auf die Länge null abgeschnitten. |
| OF_PARSE | Überspringt zeitaufwendige Vorgänge, z. B. das Erstellen eines Indexes. Legen Sie dieses Flag fest, wenn die Funktion so schnell wie möglich zurückgegeben werden soll, z. B. wenn Sie die Dateieigenschaften abfragen, aber die Datei nicht lesen möchten. |
| OF_READ | Öffnet die Datei zum Lesen. |
| OF_READWRITE | Öffnet die Datei zum Lesen und Schreiben. |
| OF_SHARE_DENY_NONE | Öffnet die Datei nichtexklusiv. Andere Prozesse können die Datei mit Lese- oder Schreibzugriff öffnen. AVIFileOpen schlägt fehl, wenn die Datei von einem anderen Prozess im Kompatibilitätsmodus geöffnet wurde. |
| OF_SHARE_DENY_READ | Öffnet die Datei nichtexklusiv. Andere Prozesse können die Datei mit Schreibzugriff öffnen. AVIFileOpen schlägt fehl, wenn ein anderer Prozess die Datei im Kompatibilitätsmodus geöffnet hat oder Lesezugriff darauf hat. |
| OF_SHARE_DENY_WRITE | Öffnet die Datei nichtexklusiv. Andere Prozesse können die Datei mit Lesezugriff öffnen. AVIFileOpen schlägt fehl, wenn ein anderer Prozess die Datei im Kompatibilitätsmodus geöffnet hat oder Schreibzugriff darauf hat. |
| OF_SHARE_EXCLUSIVE | Öffnet die Datei und verweigert anderen Prozessen den Zugriff darauf. AVIFileOpen schlägt fehl, wenn die Datei von einem anderen Prozess geöffnet wurde. |
| OF_WRITE | Öffnet die Datei zum Schreiben. |
lpHandler
Zeiger auf einen Klassenbezeichner des standard- oder benutzerdefinierten Handlers, den Sie verwenden möchten. Wenn der Wert NULL ist, wählt das System einen Handler aus der Registrierung basierend auf der Dateierweiterung oder dem in der Datei angegebenen RIFF-Typ aus.
Rückgabewert
Gibt null zurück, wenn der Vorgang erfolgreich war oder andernfalls ein Fehler. Mögliche Fehlerwerte sind:
| Rückgabecode | Beschreibung |
|---|---|
|
Die Datei konnte nicht gelesen werden, was auf eine beschädigte Datei oder ein nicht erkanntes Format hinweist. |
|
Die Datei konnte aufgrund von unzureichendem Arbeitsspeicher nicht geöffnet werden. |
|
Beim Lesen der Datei ist ein Datenträgerfehler aufgetreten. |
|
Beim Öffnen der Datei ist ein Datenträgerfehler aufgetreten. |
|
Gemäß der Registrierung verfügt der in AVIFileOpen angegebene Dateityp nicht über einen Handler zum Verarbeiten. |
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vfw.h |
| Bibliothek | Vfw32.lib |
| DLL | Avifil32.dll |