AVIStreamWrite function (vfw.h)

The AVIStreamWrite function writes data to a stream.

Syntax

HRESULT 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:

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 value

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

See also

AVIFile Functions

AVIFile Functions and Macros