AVIBuildFilterA-Funktion (vfw.h)
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
Zeiger auf den Puffer, der die Filterzeichenfolge enthält.
cbFilter
Größe des Puffers in Zeichen, auf den lpszFilter verweist.
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 erfolgreich oder andernfalls ein Fehler aufgetreten ist. Mögliche Fehlerwerte sind:
Rückgabecode | Beschreibung |
---|---|
|
Die Puffergröße cbFilter war kleiner als die generierte Filterspezifikation. |
|
Es war nicht genügend Arbeitsspeicher vorhanden, um den Lesevorgang abzuschließen. |
Hinweise
Diese Funktion greift auf die Registrierung für alle Filtertypen zu, die die AVIFile-Bibliothek zum Öffnen, Lesen oder Schreiben von Multimediadateien verwenden kann. Die Festplatte wird nicht nach Filter-DLLs und -Formaten durchsucht.
Hinweis
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 nicht codierungsneutralem Code 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 |