ICSeqCompressFrameStart

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

BOOL 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 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.

Requirements

  Windows NT/2000/XP: Included in Windows NT 3.1 and later.
  Windows 95/98/Me: Included in Windows 95 and later.
  Header: Declared in Vfw.h.
  Library: Use Vfw32.lib.

See Also

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

Show: