ICSeqCompressFrameStart function (vfw.h)

Article
10/05/2021

The ICSeqCompressFrameStart function initializes resources for compressing a sequence of frames using the ICSeqCompressFrame function.

Syntax

BOOL VFWAPI ICSeqCompressFrameStart(
  PCOMPVARS    pc,
  LPBITMAPINFO lpbiIn
);

Parameters

pc

Pointer to a COMPVARS structure initialized with information for compression.

lpbiIn

Format of the data to be compressed.

Return value

Returns TRUE if successful or FALSE otherwise.

Remarks

This function uses a COMPVARS structure to provide settings for the specified compressor and intersperses key frames at the rate specified by the lKey member of COMPVARS. You can specify values for the data rate for the sequence and the key-frame frequency by using the appropriate members of COMPVARS.

Use the ICSeqCompressFrameStart, ICSeqCompressFrame, and ICSeqCompressFrameEnd functions to compress a sequence of frames to a specified data rate and number of key frames.

When finished with compression, use the ICCompressorFree function to release the resources specified in COMPVARS.

COMPVARS needs to be initialized before you use this function. You can initialize the structure manually or you can allow the user to specify a compressor and initialize a COMPVARS structure by using the ICCompressorChoose function.

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	Msvfw32.dll