AVIFileOpenA-Funktion (vfw.h)
Die AVIFileOpen--Funktion öffnet eine AVI-Datei und gibt die Adresse einer Dateischnittstelle zurück, die für den Zugriff darauf verwendet wird. Die AVIFile-Bibliothek verwaltet eine Anzahl der Male, mit denen eine Datei geöffnet wird, aber nicht die Anzahl der Veröffentlichungen. 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
Access-Modus, der beim Öffnen der Datei verwendet werden soll. Der Standardzugriffsmodus ist OF_READ. Die folgenden Zugriffsmodi können mit AVIFileOpenangegeben werden.
| Wert | Bedeutung |
|---|---|
| OF_CREATE | Erstellt eine neue Datei. Wenn die Datei bereits vorhanden ist, wird sie auf null Länge abgeschnitten. |
| OF_PARSE | Überspringt zeitaufwendige Vorgänge, z. B. das Erstellen eines Indexes. Legen Sie dieses Kennzeichen fest, wenn die Funktion so schnell wie möglich zurückgegeben werden soll , z. B. wenn Sie die Dateieigenschaften abfragen, die Datei aber 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 nicht ausschließlich. 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 nicht ausschließlich. 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 nicht ausschließlich. 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 ein anderer Prozess die Datei geöffnet hat. |
| OF_WRITE | Öffnet die Datei zum Schreiben. |
lpHandler
Zeigen Sie 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 dies erfolgreich ist oder andernfalls ein Fehler auftritt. 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 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. |
Bemerkungen
Anmerkung
Der Vfw.h-Header definiert AVIFileOpen als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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 |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | vfw.h |
| Library | Vfw32.lib |
| DLL- | Avifil32.dll |