Funzione AVIBuildFilterA (vfw.h)

La funzione AVIBuildFilter compila una specifica di filtro usata successivamente dalla funzione GetOpenFileName o GetSaveFileName .

Sintassi

HRESULT AVIBuildFilterA(
  LPSTR lpszFilter,
  LONG  cbFilter,
  BOOL  fSaving
);

Parametri

lpszFilter

Puntatore al buffer contenente la stringa di filtro.

cbFilter

Dimensioni, in caratteri, del buffer a cui punta lpszFilter.

fSaving

Flag che indica se il filtro deve includere formati di lettura o scrittura. Specificare TRUE per includere formati di scrittura o FALSE per includere i formati di lettura.

Valore restituito

Restituisce AVIERR_OK in caso di esito positivo o di errore in caso contrario. I valori di errore possibili includono quanto segue.

Codice restituito	Descrizione
AVIERR_BUFFERTOOSMALL	Le dimensioni del buffer cbFilter sono inferiori alla specifica del filtro generata.
AVIERR_MEMORY	Memoria insufficiente per completare l'operazione di lettura.

Commenti

Questa funzione accede al Registro di sistema per tutti i tipi di filtro che la libreria AVIFile può usare per aprire, leggere o scrivere file multimediali. Non esegue ricerche nel disco rigido per individuare DLL e formati di filtro.

Nota

L'intestazione vfw.h definisce AVIBuildFilter come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vfw.h
Libreria	Vfw32.lib
DLL	Avifil32.dll

Vedi anche

Funzioni AVIFile

Funzioni e macro AVIFile