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 |
|---|---|
|
Le dimensioni del buffer cbFilter sono inferiori alla specifica del filtro generata. |
|
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 |