AVIStreamWrite-Funktion (vfw.h)

Die AVIStreamWrite-Funktion schreibt Daten in einen Stream.

Syntax

HRESULT AVIStreamWrite(
  PAVISTREAM pavi,
  LONG       lStart,
  LONG       lSamples,
  LPVOID     lpBuffer,
  LONG       cbBuffer,
  DWORD      dwFlags,
  LONG       *plSampWritten,
  LONG       *plBytesWritten
);

Parameter

pavi

Handle für einen geöffneten Stream.

lStart

Erstes zu schreibende Beispiel.

lSamples

Anzahl der zu schreibenden Beispiele.

lpBuffer

Zeiger auf einen Puffer, der die zu schreibenden Daten enthält.

cbBuffer

Größe des Puffers, auf den von lpBuffer verwiesen wird.

dwFlags

Flag, das diesen Daten zugeordnet ist. Das folgende Flag ist definiert:

Wert	Bedeutung
AVIIF_KEYFRAME	Gibt an, dass diese Daten nicht auf vorherigen Daten in der Datei basieren.

plSampWritten

Zeiger auf einen Puffer, der die Anzahl der geschriebenen Beispiele empfängt. Dies kann auf NULL festgelegt werden.

plBytesWritten

Zeiger auf einen Puffer, der die Anzahl der geschriebenen Bytes empfängt. Dies kann auf NULL festgelegt werden.

Rückgabewert

Gibt null zurück, wenn erfolgreich oder andernfalls ein Fehler auftritt.

Hinweise

Der Standardmäßige AVI-Dateihandler unterstützt das Schreiben nur am Ende eines Datenstroms. Der "WAVE"-Dateihandler unterstützt das Schreiben von überall.

Diese Funktion überschreibt vorhandene Daten, anstatt neue Daten einzufügen.

Das Argument pavi ist ein Zeiger auf eine IAVIStream-Schnittstelle .

Anforderungen

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