AVISaveVA-Funktion (vfw.h)
Die AVISaveV--Funktion erstellt eine Datei, indem Datenströme aus anderen Dateien oder aus dem Speicher kombiniert werden.
Syntax
HRESULT AVISaveVA(
LPCSTR szFile,
CLSID *pclsidHandler,
AVISAVECALLBACK lpfnCallback,
int nStreams,
PAVISTREAM *ppavi,
LPAVICOMPRESSOPTIONS *plpOptions
);
Parameter
szFile
Null-beendete Zeichenfolge, die den Namen der zu speichernden Datei enthält.
pclsidHandler
Zeiger auf den Dateihandler, der zum Schreiben der Datei verwendet wird. Die Datei wird durch Aufrufen der AVIFileOpen--Funktion mithilfe dieses Handlers erstellt. Wenn kein Handler angegeben ist, wird eine Standardeinstellung basierend auf der Dateierweiterung aus der Registrierung ausgewählt.
lpfnCallback
Zeiger auf eine Rückruffunktion zum Anzeigen von Statusinformationen und zum Abbrechen des Speichervorgangs durch den Benutzer.
nStreams
Anzahl der zu speichernden Datenströme.
ppavi
Zeigen Sie auf ein Array von Zeigern auf die AVISTREAM- Funktionsstrukturen. Das Array verwendet einen Zeiger für jeden Datenstrom.
plpOptions
Zeiger auf ein Array von Zeigern auf AVICOMPRESSOPTIONS- Strukturen. Das Array verwendet einen Zeiger für jeden Datenstrom.
Rückgabewert
Gibt AVIERR_OK zurück, wenn dies erfolgreich ist oder ein Fehler andernfalls auftritt.
Bemerkungen
Diese Funktion entspricht der AVISave--Funktion, mit der Ausnahme, dass die Datenströme in einem Array statt als variable Anzahl von Argumenten übergeben werden.
Diese Funktion erstellt eine Datei, kopiert Datenstromdaten in die Datei, schließt die Datei und gibt die von der neuen Datei verwendeten Ressourcen frei. Die letzten beiden Parameter dieser Funktion sind Arrays, die die Datenströme identifizieren, die in der Datei gespeichert werden sollen, und die Komprimierungsoptionen dieser Datenströme definieren.
Eine Anwendung muss Speicher für die AVICOMPRESSOPTIONS- Strukturen und das Array von Zeigern auf diese Strukturen zuweisen.
Das Argument ppavi enthält die Adresse eines Zeigers auf eine IAVIStream Schnittstelle.
Anmerkung
Der vfw.h-Header definiert AVISaveV als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | vfw.h |
| Library | Vfw32.lib |
| DLL- | Avifil32.dll |