AVISaveVA-Funktion (vfw.h)
Die AVISaveV-Funktion erstellt eine Datei, indem Datenströme aus anderen Dateien oder aus dem Arbeitsspeicher 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 erstellt, indem die FUNKTION AVIFileOpen mithilfe dieses Handlers aufgerufen wird. Wenn kein Handler angegeben ist, wird in der Registrierung basierend auf der Dateierweiterung ein Standardwert ausgewählt.
lpfnCallback
Zeiger auf eine Rückruffunktion, mit der status Informationen angezeigt und der Benutzer den Speichervorgang abbrechen kann.
nStreams
Anzahl der zu speichernden Streams.
ppavi
Zeiger auf ein Array von Zeigern auf die AVISTREAM-Funktionsstrukturen . Das Array verwendet einen Zeiger für jeden Stream.
plpOptions
Zeiger auf ein Array von Zeigern auf AVICOMPRESSOPTIONS-Strukturen . Das Array verwendet einen Zeiger für jeden Stream.
Rückgabewert
Gibt AVIERR_OK zurück, wenn erfolgreich oder andernfalls ein Fehler aufgetreten ist.
Hinweise
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 Streamdaten 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 Arbeitsspeicher 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 .
Hinweis
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 nicht codierungsneutralem Code 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 |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vfw.h |
| Bibliothek | Vfw32.lib |
| DLL | Avifil32.dll |