AVIMakeCompressedStream function (vfw.h)

Article
02/22/2024

The AVIMakeCompressedStream function creates a compressed stream from an uncompressed stream and a compression filter, and returns the address of a pointer to the compressed stream. This function supports audio and video compression.

Syntax

HRESULT AVIMakeCompressedStream(
  PAVISTREAM         *ppsCompressed,
  PAVISTREAM         ppsSource,
  AVICOMPRESSOPTIONS *lpOptions,
  CLSID              *pclsidHandler
);

Parameters

ppsCompressed

Pointer to a buffer that receives the compressed stream pointer.

ppsSource

Pointer to the stream to be compressed.

lpOptions

Pointer to a structure that identifies the type of compression to use and the options to apply. You can specify video compression by identifying an appropriate handler in the AVICOMPRESSOPTIONS structure. For audio compression, specify the compressed data format.

pclsidHandler

Pointer to a class identifier used to create the stream.

Return value

Returns AVIERR_OK if successful or an error otherwise. Possible error values include the following.

Return code	Description
AVIERR_NOCOMPRESSOR	A suitable compressor cannot be found.
AVIERR_MEMORY	There is not enough memory to complete the operation.
AVIERR_UNSUPPORTED	Compression is not supported for this type of data. This error might be returned if you try to compress data that is not audio or video.

Remarks

Applications can read from or write to the compressed stream.

A PAVISTREAM is a pointer to an IAVIStream interface.

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
DLL	Avifil32.dll