AVIFileOpen-Funktion (vfw.h)

  • Artikel

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
AVIERR_BADFORMAT
 Die Datei konnte nicht gelesen werden, was auf eine beschädigte Datei oder ein nicht erkanntes Format hinweist.
AVIERR_MEMORY
 Die Datei konnte aufgrund von unzureichendem Arbeitsspeicher nicht geöffnet werden.
AVIERR_FILEREAD
 Beim Lesen der Datei ist ein Datenträgerfehler aufgetreten.
AVIERR_FILEOPEN
 Beim Öffnen der Datei ist ein Datenträgerfehler aufgetreten.
REGDB_E_CLASSNOTREG
 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

Weitere Informationen

AVIFile-Funktionen

AVIFile-Funktionen und -Makros

AVIFileRelease