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 erstellt, indem die AVIFileOpen-Funktion mithilfe dieses Handlers aufgerufen wird. Wenn kein Handler angegeben ist, wird basierend auf der Dateierweiterung aus der Registrierung ein Standardwert ausgewählt.
lpfnCallback
Zeiger auf eine Rückruffunktion für den Speichervorgang.
nStreams
Anzahl der in der Datei gespeicherten Streams.
pfile
Zeiger auf einen AVI-Stream. Dieser Parameter wird mit lpOptions gekoppelt. Das Parameterpaar kann als variable Anzahl von Argumenten wiederholt werden.
lpOptions
Zeiger auf eine anwendungsdefinierte AVICOMPRESSOPTIONS-Struktur , die die Komprimierungsoptionen für den Datenstrom enthält, auf den von pavi verwiesen wird. Dieser Parameter wird mit pavi gekoppelt. Das Parameterpaar kann als variable Anzahl von Argumenten wiederholt werden.
...
Rückgabewert
Gibt AVIERR_OK zurück, wenn erfolgreich oder andernfalls ein Fehler auftritt.
Hinweise
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 identifizieren einen Stream, der in der Datei gespeichert werden soll, und definieren die Komprimierungsoptionen dieses Datenstroms. Wenn Sie mehr als einen Stream in einer AVI-Datei speichern, wiederholen Sie diese beiden datenstromspezifischen Parameter für jeden Stream in der Datei.
Eine Rückruffunktion (auf die mithilfe von lpfnCallback verwiesen wird) kann status Informationen anzeigen und dem Benutzer ermöglichen, den Speichervorgang abzubrechen. 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 .
Hinweis
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 |
---|---|
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 |