Funzione AVISaveW (vfw.h)

Articolo
11/20/2024

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

Sintassi

HRESULT AVISaveW(
  LPCWSTR              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 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 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 definita dall'applicazione AVICOMPRESSOPTIONS 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 in caso di esito positivo o di errore.

Osservazioni

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 identificano un flusso da salvare nel file e definiscono le opzioni di compressione del 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 viene fatto riferimento tramite lpfnCallback) può visualizzare informazioni sullo stato e consentire all'utente di annullare l'operazione di salvataggio. La funzione di 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 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