Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die AVIBuildFilter--Funktion erstellt eine Filterspezifikation, die anschließend von der GetOpenFileName oder GetSaveFileName-Funktion verwendet wird.
Syntax
HRESULT AVIBuildFilterA(
LPSTR 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 |