IAVIStream::Write

  • Article

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

Pointer to the interface to a stream.

lStart

Starting sample or frame number to write.

lSamples

Number of samples to write.

lpBuffer

Pointer to 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

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

plBytesWritten

Pointer to a buffer that receives 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);

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

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