ICLocate function (vfw.h)

The ICLocate function finds a compressor or decompressor that can handle images with the specified formats, or finds a driver that can decompress an image with a specified format directly to hardware.

Syntax

HIC VFWAPI ICLocate(
  DWORD              fccType,
  DWORD              fccHandler,
  LPBITMAPINFOHEADER lpbiIn,
  LPBITMAPINFOHEADER lpbiOut,
  WORD               wFlags
);

Parameters

fccType

Four-character code indicating the type of compressor or decompressor to open. For video streams, the value of this parameter is 'VIDC'.

fccHandler

Preferred handler of the specified type. Typically, the handler type is stored in the stream header in an AVI file. Specify NULL if your application can use any handler type or it does not know the handler type to use.

lpbiIn

Pointer to a BITMAPINFOHEADER structure defining the input format. A compressor handle is not returned unless it supports this format.

lpbiOut

Pointer to a BITMAPINFOHEADER structure defining an optional decompressed format. You can also specify zero to use the default output format associated with the input format.

If this parameter is nonzero, a compressor handle is not returned unless it can create this output format.

wFlags

Flags that describe the search criteria for a compressor or decompressor. The following values are defined:

Return value

Returns a handle to a compressor or decompressor if successful or zero otherwise.

Requirements

See also

Video Compression Functions

Video Compression Manager