AVIStreamWrite

The AVIStreamWrite function writes data to a stream.

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

Parameters

pavi

Handle to an open stream.

lStart

First sample to write.

lSamples

Number of samples to write.

lpBuffer

Pointer to a buffer containing the data to write.

cbBuffer

Size of the buffer referenced by lpBuffer.

dwFlags

Flag associated with this data. The following flag is defined:

AVIIF_KEYFRAME

Indicates this data does not rely on preceding data in the file.

plSampWritten

Pointer to a buffer that receives the number of samples written. This can be set to NULL.

plBytesWritten

Pointer to a buffer that receives the number of bytes written. This can be set to NULL.

Return Values

Returns zero if successful or an error otherwise.

Remarks

The default AVI file handler supports writing only at the end of a stream. The "WAVE" file handler supports writing anywhere.

This function overwrites existing data, rather than inserting new data.

The argument pavi is a pointer to an IAVIStream interface.

Requirements

**  Windows NT/2000/XP:** Included in Windows NT 3.1 and later.
**  Windows 95/98/Me:** Included in Windows 95 and later.
**  Header:** Declared in Vfw.h.
**  Library:** Use Vfw32.lib.

See Also

AVIFile Functions and Macros, AVIFile Functions