ICInstall

The ICInstall function installs a new compressor or decompressor.

BOOL ICInstall(
  DWORD fccType,     
  DWORD fccHandler,  
  LPARAM lParam,     
  LPSTR szDesc,      
  UINT wFlags        
);

Parameters

fccType

Four-character code indicating the type of data used by the compressor or decompressor. Specify "VIDC" for a video compressor or decompressor.

fccHandler

Four-character code identifying a specific compressor or decompressor.

lParam

Pointer to a null-terminated string containing the name of the compressor or decompressor, or the address of a function used for compression or decompression. The contents of this parameter are defined by the flags set for wFlags.

szDesc

Reserved; do not use.

wFlags

Flags defining the contents of lParam. The following values are defined.

Value Meaning
ICINSTALL_DRIVER The lParam parameter contains the address of a
null-terminated string that names the compressor to install.
ICINSTALL_FUNCTION The lParam parameter contains the address of a compressor function. This function should be structured like the DriverProc entry point function used by compressors.

Return Values

Returns ICERR_OK if successful or an error otherwise.

Remarks

Applications must open an installed compressor or decompressor before using it.

If your application installs a function as a compressor or decompressor, it should remove the function with the ICRemove function before it terminates. This prevents other applications from trying to access the function when it is not available.

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, DriverProc, ICRemove

Show: