AVISaveVA-Funktion (vfw.h)

  • Artikel

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

Weitere Informationen

AVIFile-Funktionen

AVIFile-Funktionen und -Makros