IAVIStream::SetFormat method

The SetFormat method sets format information in a stream. Called when an application uses the AVIStreamSetFormat function.


HRESULT SetFormat(
  LONG   lPos,
  LPVOID lpFormat,
  LONG   cbFormat



Pointer to the interface to a stream.


Pointer to the buffer for the format data.


Address containing the size, in bytes, of the buffer specified by lpFormat.

Return Value

Returns the HRESULT defined by OLE.


Standard video stream handlers provide format information in a BITMAPINFOHEADER structure. Standard audio stream handlers provide format information in a PCMWAVEFORMAT structure. Other data streams can use other structures that describe the stream data.

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

HRESULT SetFormat(LONG lPos, LPVOID lpFormat, LONG cbFormat) 


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

See Also

Custom File and Stream Handler Interfaces

Custom File and Stream Handlers