Funzione AVIBuildFilterW (vfw.h)

Articolo
11/20/2024

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

Sintassi

HRESULT AVIBuildFilterW(
  LPWSTR 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. I possibili valori di errore includono quanto segue.

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

Osservazioni

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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	vfw.h
libreria	Vfw32.lib
dll	Avifil32.dll

Vedere anche

funzioni AVIFile

funzioni AVIFile e macro

Condividi tramite