AVISaveA-Funktion (vfw.h)
Die AVISave-Funktion erstellt eine Datei, indem Datenströme aus anderen Dateien oder aus dem Arbeitsspeicher kombiniert werden.
Syntax
HRESULT AVISaveA(
LPCSTR szFile,
CLSID *pclsidHandler,
AVISAVECALLBACK lpfnCallback,
int nStreams,
PAVISTREAM pfile,
LPAVICOMPRESSOPTIONS lpOptions,
...
);
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 für den Speichervorgang.
nStreams
Die Anzahl der in der Datei gespeicherten Datenströme.
pfile
Zeiger auf einen AVI-Stream. Dieser Parameter wird mit lpOptionsgekoppelt. Das Parameterpaar kann als variable Anzahl von Argumenten wiederholt werden.
lpOptions
Zeiger auf eine anwendungsdefinierte AVICOMPRESSOPTIONS- Struktur, die die Komprimierungsoptionen für den Von pavireferenzierten Datenstrom enthält. Dieser Parameter wird mit pavi gekoppelt. Das Parameterpaar kann als variable Anzahl von Argumenten wiederholt werden.
...
Rückgabewert
Gibt AVIERR_OK zurück, wenn dies erfolgreich ist oder ein Fehler andernfalls auftritt.
Bemerkungen
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 identifizieren einen Datenstrom, der in der Datei gespeichert werden soll, und definieren die Komprimierungsoptionen dieses Datenstroms. Wiederholen Sie beim Speichern mehrerer Datenströme in einer AVI-Datei diese beiden streamspezifischen Parameter für jeden Datenstrom in der Datei.
Eine Rückruffunktion (auf die mithilfe von lpfnCallbackverwiesen wird) kann Statusinformationen anzeigen und dem Benutzer das Abbrechen des Speichervorgangs ermöglichen. Die Rückruffunktion verwendet das folgende Format:
LONG PASCAL SaveCallback(int nPercent)
Der parameter nPercent gibt den Prozentsatz der gespeicherten Datei an.
Die Rückruffunktion sollte AVIERR_OK zurückgeben, wenn der Vorgang fortgesetzt werden soll, und AVIERR_USERABORT, wenn der Benutzer den Speichervorgang abbrechen möchte.
Das Argument pavi ist ein Zeiger auf eine IAVIStream Schnittstelle.
Anmerkung
Der vfw.h-Header definiert AVISave 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 |