AVISaveOptions-Funktion (vfw.h)

Die AVISaveOptions-Funktion ruft die Speicheroptionen für eine Datei ab und gibt sie in einem Puffer zurück.

Syntax

INT_PTR AVISaveOptions(
  HWND                 hwnd,
  UINT                 uiFlags,
  int                  nStreams,
  PAVISTREAM           *ppavi,
  LPAVICOMPRESSOPTIONS *plpOptions
);

Parameter

hwnd

Handle zum übergeordneten Fenster für das Dialogfeld Komprimierungsoptionen.

uiFlags

Flags zum Anzeigen des Dialogfelds Komprimierungsoptionen. Die folgenden Flags sind definiert.

Wert	Bedeutung
ICMF_CHOOSE_KEYFRAME	Zeigt das Dialogfeld Keyframe Alle für die Videooptionen an. Dies ist dasselbe Flag, das in der ICCompressorChoose-Funktion verwendet wird.
ICMF_CHOOSE_DATARATE	Zeigt ein Dialogfeld Datenrate für die Videooptionen an. Dies ist dasselbe Flag, das in ICCompressorChoose verwendet wird.
ICMF_CHOOSE_PREVIEW	Zeigt eine Vorschauschaltfläche für die Videooptionen an. Mit dieser Schaltfläche wird eine Vorschau der Komprimierung mithilfe eines Frames aus dem Stream angezeigt. Dies ist dasselbe Flag, das in ICCompressorChoose verwendet wird.

nStreams

Anzahl der Datenströme, deren Optionen im Dialogfeld festgelegt sind.

ppavi

Zeiger auf ein Array von Datenstromschnittstellenzeigern. Der nStreams-Parameter gibt die Anzahl der Zeiger im Array an.

plpOptions

Zeiger auf ein Array von Zeigern auf AVICOMPRESSOPTIONS-Strukturen . Diese Strukturen enthalten die vom Dialogfeld festgelegten Komprimierungsoptionen. Der nStreams-Parameter gibt die Anzahl der Zeiger im Array an.

Rückgabewert

Gibt TRUE zurück, wenn der Benutzer OK, FALSE für CANCEL oder andernfalls einen Fehler gedrückt hat.

Hinweise

Diese Funktion stellt ein Standardmäßiges Dialogfeld Komprimierungsoptionen mit hwnd als übergeordnetem Fensterhandle dar. Wenn der Benutzer die Auswahl der Komprimierungsoptionen für jeden Stream abgeschlossen hat, werden die Optionen in der AVICOMPRESSOPTIONS-Struktur in dem Array zurückgegeben, auf das von plpOptions verwiesen wird. Die aufrufende Anwendung muss die Schnittstellenzeiger für die Datenströme im Array übergeben, auf das von ppavi verwiesen wird.

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 .

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