Funzione AVISaveVA (vfw.h)

La funzione AVISaveV compila un file combinando flussi di dati da altri file o dalla memoria.

Sintassi

HRESULT AVISaveVA(
  LPCSTR               szFile,
  CLSID                *pclsidHandler,
  AVISAVECALLBACK      lpfnCallback,
  int                  nStreams,
  PAVISTREAM           *ppavi,
  LPAVICOMPRESSOPTIONS *plpOptions
);

Parametri

szFile

Stringa con terminazione Null contenente il nome del file da salvare.

pclsidHandler

Puntatore al gestore di file usato per scrivere il file. Il file viene creato chiamando la funzione AVIFileOpen usando questo gestore. Se non viene specificato un gestore, viene selezionato un valore predefinito dal Registro di sistema in base all'estensione di file.

lpfnCallback

Puntatore a una funzione di callback usata per visualizzare le informazioni sullo stato e consentire all'utente di annullare l'operazione di salvataggio.

nStreams

Numero di flussi da salvare.

ppavi

Puntatore a una matrice di puntatori alle strutture della funzione AVISTREAM . La matrice usa un puntatore per ogni flusso.

plpOptions

Puntatore a una matrice di puntatori alle strutture AVICOMPRESSOPTIONS . La matrice usa un puntatore per ogni flusso.

Valore restituito

Restituisce AVIERR_OK in caso di esito positivo o di errore in caso contrario.

Commenti

Questa funzione equivale alla funzione AVISave , ad eccezione dei flussi passati in una matrice anziché come numero variabile di argomenti.

Questa funzione crea un file, copia i dati del flusso nel file, chiude il file e rilascia le risorse usate dal nuovo file. Gli ultimi due parametri di questa funzione sono matrici che identificano i flussi da salvare nel file e definiscono le opzioni di compressione di tali flussi.

Un'applicazione deve allocare memoria per le strutture AVICOMPRESSOPTIONS e la matrice di puntatori a queste strutture.

L'argomento ppavi contiene l'indirizzo di un puntatore a un'interfaccia IAVIStream .

Nota

L'intestazione vfw.h definisce AVISaveV 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