ICCompressBegin macro (vfw.h)

The ICCompressBegin macro notifies a video compression driver to prepare to compress data. You can use this macro or explicitly call the ICM_COMPRESS_BEGIN message.

Syntax

void ICCompressBegin(
   hic,
   lpbiInput,
   lpbiOutput
);

Parameters

hic

Handle to a compressor.

lpbiInput

Pointer to a BITMAPINFO structure containing the input format.

lpbiOutput

Pointer to a BITMAPINFO structure containing the output format.

Return value

None

Remarks

The driver should allocate and initialize any tables or memory that it needs for compressing the data formats when it receives the ICM_COMPRESS message.

VCM saves the settings of the most recent ICCompressBegin macro. The ICCompressBegin and ICCompressEnd messages do not nest. If your driver receives ICM_COMPRESS_BEGIN before compression is stopped with ICM_COMPRESS_END, it should restart compression with new parameters.

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

See also

Video Compression Macros

Video Compression Manager