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
AVIERR_BUFFERTOOSMALL	Die Puffergröße cbFilter war kleiner als die generierte Filterspezifikation.
AVIERR_MEMORY	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

Weitere Informationen

AVIFile-Funktionen

AVIFile-Funktionen und -Makros