Funzione AVISaveA (vfw.h)
La funzione AVISave compila un file combinando i flussi di dati da altri file o dalla memoria.
Sintassi
HRESULT AVISaveA(
LPCSTR szFile,
CLSID *pclsidHandler,
AVISAVECALLBACK lpfnCallback,
int nStreams,
PAVISTREAM pfile,
LPAVICOMPRESSOPTIONS lpOptions,
...
);
Parametri
szFile
Stringa con terminazione null contenente il nome del file da salvare.
pclsidHandler
Puntatore al gestore file usato per scrivere il file. Il file viene creato chiamando la funzione AVIFileOpen usando questo gestore. Se un gestore non è specificato, viene selezionato un valore predefinito dal Registro di sistema in base all'estensione del file.
lpfnCallback
Puntatore a una funzione di callback per l'operazione di salvataggio.
nStreams
Numero di flussi salvati nel file.
pfile
Puntatore a un flusso AVI. Questo parametro è associato a lpOptions. La coppia di parametri può essere ripetuta come numero variabile di argomenti.
lpOptions
Puntatore a una struttura AVICOMPRESSOPTIONS definita dall'applicazione contenente le opzioni di compressione per il flusso a cui fa riferimento pavi. Questo parametro è associato a pavi. La coppia di parametri può essere ripetuta come numero variabile di argomenti.
...
Valore restituito
Restituisce AVIERR_OK se ha esito positivo o un errore in caso contrario.
Commenti
Questa funzione crea un file, copia i dati di flusso nel file, chiude il file e rilascia le risorse usate dal nuovo file. Gli ultimi due parametri di questa funzione identificano un flusso per salvare nel file e definire le opzioni di compressione di tale flusso. Quando si salvano più flussi in un file AVI, ripetere questi due parametri specifici del flusso per ogni flusso nel file.
Una funzione di callback (a cui si fa riferimento usando lpfnCallback) può visualizzare le informazioni sullo stato e consentire all'utente di annullare l'operazione di salvataggio. La funzione callback usa il formato seguente:
LONG PASCAL SaveCallback(int nPercent)
Il parametro nPercent specifica la percentuale del file salvato.
La funzione di callback deve restituire AVIERR_OK se l'operazione deve continuare e AVIERR_USERABORT se l'utente desidera interrompere l'operazione di salvataggio.
L'argomento pavi è un puntatore a un'interfaccia IAVIStream .
Nota
L'intestazione vfw.h definisce AVISave come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
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 |