IAVIStream::Write

The Write method writes data to a stream. Called when an application uses the AVIStreamWrite function.

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

Parameters

ps

Address of the interface to a stream.

lStart

Starting sample or frame number to write.

lSamples

Number of samples to write.

lpBuffer

Address of the buffer for the data.

cbBuffer

Size, in bytes, of the buffer specified by lpBuffer.

dwFlags

Applicable flags. The AVIF_KEYFRAME flag is defined and indicates that this frame contains all the information needed for a complete image.

plSampWritten

Address of a buffer used to contain the number of samples written.

plBytesWritten

Address to contain the number of bytes written.

Return Values

Returns the HRESULT defined by OLE.

Remarks

For handlers written in C++, Write has the following syntax:

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

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

Custom File and Stream Handlers Overview, Custom File and Stream Handler Interfaces, AVIStreamWrite