AVISaveA-Funktion (vfw.h)

  • Artikel

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

Weitere Informationen

AVIFile-Funktionen

AVIFile-Funktionen und -Makros