ICSeqCompressFrameStart

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

BOOL ICSeqCompressFrameStart(
  PCOMPVARS pc,        
  LPBITMAPINFO lpbiIn  
);
 

Parameters

pc

Address of a COMPVARS structure initialized with information for compression.

lpbiIn

Format of the data to be compressed.

Return Values

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.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in vfw.h.
  Import Library: Use vfw32.lib.

See Also

Video Compression Manager Overview, Video Compression Functions, ICSeqCompressFrame, ICSeqCompressFrameEnd, ICCompressorFree, ICCompressorChoose, COMPVARS