IAVIStream::Write method (vfw.h)

Article
02/22/2024

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

Syntax

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

Parameters

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 value

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

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	vfw.h
Library	Vfw32.lib