ICOPEN

typedef struct {
    DWORD dwSize;
    DWORD fccType;
    DWORD fccHandler;
    DWORD dwVersion;
    DWORD dwFlags;
    DWORD dwError;
    LPVOID pV1Reserved;
    LPVOID pV2Reserved;
    DWORD dnDevNode;
} ICOPEN;

The ICOPEN structure is sent to a video compression or decompression driver with the DRV_OPEN message.

Members

dwSize

Specifies the size of the structure.

fccType

Specifies a four-character code representing the type of stream being compressed or decompressed. For video streams, this should be ‘vidc’.

fccHandler

Specifies a four-character code identifying a specific compressor.

dwVersion

Specifies the version of the installable driver interface used to open the driver.

dwFlags

Contains flags indicating why the driver is opened. The following flags are defined:

Flag	Meaning
ICMODE_COMPRESS	The driver is opened to compress data.
ICMODE_DECOMPRESS	The driver is opened to decompress data.
ICMODE_QUERY	The driver is opened for informational purposes rather than for actual compression.
ICMODE_DRAW	The device driver is opened to decompress data directly to hardware.

dwError

Specifies error return values.

pV1Reserved

Reserved.

pV2Reserved

Reserved.

dnDevNode

Device node for Plug and Play devices.

Comments

This structure is the same as that passed to video-capture drivers when they are opened. This lets a single installable driver function as either an installable compressor or a video-capture device. By examining the fccType member of the ICOPEN structure, the driver can determine its function. For example, an fccType value of ‘vidc’ indicates that it is opened as an installable video compressor.