AVISaveVW-Funktion (vfw.h)
Die AVISaveV-Funktion erstellt eine Datei, indem Datenströme aus anderen Dateien oder aus dem Arbeitsspeicher kombiniert werden.
Syntax
HRESULT AVISaveVW(
LPCWSTR 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 ein Handler nicht angegeben wird, wird eine Standardeinstellung basierend auf der Dateierweiterung aus der Registrierung ausgewählt.
lpfnCallback
Zeiger auf eine Rückruffunktion, die zum Anzeigen von Statusinformationen verwendet wird, und damit der Benutzer den Speichervorgang abbrechen kann.
nStreams
Anzahl der zu speichernden Datenströme.
ppavi
Zeiger 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 ein Fehler erfolgreich oder andernfalls aufgetreten ist.
Hinweise
Diese Funktion entspricht der AVISave-Funktion , außer 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 veröffentlicht die von der neuen Datei verwendeten Ressourcen. 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 .
Hinweis
Der Vfw.h-Header definiert AVISaveV als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstanten automatisch auswählt. Das Mischen der Verwendung des Codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann dazu führen, dass keine Übereinstimmungen auftreten, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| 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 |