AVIFileOpenA-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 Geöffneten einer Datei, aber nicht die Anzahl der Freigaben. Verwenden Sie die AVIFileRelease-Funktion , um die Datei freizugeben und die Anzahl zu verringern.

Syntax

HRESULT AVIFileOpenA(
  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 0 (null) abgeschnitten.
OF_PARSE Überspringt zeitaufwändige 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 ein anderer Prozess die Datei im Kompatibilitätsmodus geöffnet hat.
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 über Schreibzugriff darauf verfügt.
OF_SHARE_EXCLUSIVE Öffnet die Datei und verweigert anderen Prozessen den Zugriff darauf. AVIFileOpen schlägt fehl, wenn ein anderer Prozess die Datei geöffnet hat.
OF_WRITE Öffnet die Datei zum Schreiben.

lpHandler

Zeiger auf einen Klassenbezeichner des Standardhandlers oder benutzerdefinierten Handlers, den Sie verwenden möchten. Wenn der Wert NULL ist, wählt das System basierend auf der Dateierweiterung oder dem in der Datei angegebenen RIFF-Typ einen Handler aus der Registrierung aus.

Rückgabewert

Gibt null zurück, wenn erfolgreich oder andernfalls ein Fehler auftritt. Mögliche Fehlerwerte sind:

Rückgabecode Beschreibung
AVIERR_BADFORMAT
 Die Datei konnte nicht gelesen werden, was auf eine beschädigte Datei oder ein unbekanntes Format hinweist.
AVIERR_MEMORY
 Die Datei konnte aufgrund 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 für die Verarbeitung.

Hinweise

Hinweis

Der vfw.h-Header definiert AVIFileOpen als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
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