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 of an open stream.

lStart

First sample to write.

lSamples

Number of samples to write.

lpBuffer

Address of 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

Address to contain the number of samples written. This can be set to NULL.

plBytesWritten

Address to contain 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.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in vfw.h.
  Import Library: Use vfw32.lib.

See Also

AVIFile Functions and Macros Overview, AVIFile Functions