AVIBuildFilterW-Funktion (vfw.h)
Die AVIBuildFilter--Funktion erstellt eine Filterspezifikation, die anschließend von der GetOpenFileName oder GetSaveFileName-Funktion verwendet wird.
Syntax
HRESULT AVIBuildFilterW(
LPWSTR lpszFilter,
LONG cbFilter,
BOOL fSaving
);
Parameter
lpszFilter
Zeigen Sie auf den Puffer, der die Filterzeichenfolge enthält.
cbFilter
Größe des Puffers in Zeichen, auf den lpszFilterverweist.
fSaving
Flag, das angibt, ob der Filter Lese- oder Schreibformate enthalten soll. Geben Sie TRUE- an, um Schreibformate einzuschließen, oder FALSE-, um Leseformate einzuschließen.
Rückgabewert
Gibt AVIERR_OK zurück, wenn dies erfolgreich ist oder ein Fehler andernfalls auftritt. Mögliche Fehlerwerte sind:
| Rückgabecode | Beschreibung |
|---|---|
|
Die Puffergröße cbFilter- kleiner als die generierte Filterspezifikation. |
|
Es war nicht genügend Arbeitsspeicher vorhanden, um den Lesevorgang abzuschließen. |
Bemerkungen
Diese Funktion greift auf die Registrierung für alle Filtertypen zu, die von der AVIFile-Bibliothek zum Öffnen, Lesen oder Schreiben von Multimediadateien verwendet werden können. Die Festplatte wird nicht nach Filter-DLLs und -Formaten durchsucht.
Anmerkung
Der Vfw.h-Header definiert AVIBuildFilter 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 |
|---|---|
| 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 |