Digital Video Extensions

DWORD lParam1

The following additional flags apply to digital-video devices:

MCI_DGV_SET_SEEK_EXACTLY

Sets the format used for positioning. This flag must be used with MCI_SET_ON or MCI_SET_OFF. If MCI_SET_ON is specified, the device driver uses the seek exactly format. When enabled, playing or recording precisely accesses the frame specified with the MCI_FROM flag. This might add some extra delay if the requested frame is not key frame.

If MCI_SET_OFF is specified, the device will seek to a key-frame image that precedes the requested frame. For some files and some devices, this might be the first frame of the file.

The default for this flag is device dependent.

MCI_DGV_SET_FILEFORMAT

Specifies that a file format parameter is included in the dwFileFormat field of the data structure identified by lParam2. For digital-video devices, the file format is used for save or capture commands. If omitted, this might default to a device driver defined format. If the specified file format conflicts with the currently selected algorithm and quality then they are changed to the defaults for the file format. The following file format constants are defined:


MCI_DGV_FF_AVSS

Specifies AVSS format.

MCI_DGV_FF_AVI

Specifies AVI format.

MCI_DGV_FF_DIB

Specifies DIB format.

MCI_DGV_FF_JPEG

Specifies JPEG format.

MCI_DGV_FF_MPEG

Specifies MPEG format.

MCI_DGV_FF_RDIB

Specifies RLE DIB format.

MCI_DGV_FF_JFIF

Specifies JFIF format.

MCI_DGV_FF_RJPEG

Specifies RJPEG format.


MCI_DGV_SET_SPEED

Specifies that a speed parameter is included in the dwSpeed field of the data structure identified by lParam2. Speed is specified as a ratio between the nominal frame rate and the desired frame rate where the nominal frame rate is designated as 1000. Half speed is 500 and double speed is 2000. The allowable speed range is device, and possibly file, dependent.

MCI_DGV_SET_STILL

When used with MCI_DGV_SET_FILEFORMAT, MCI_SET sets the file format used for capture commands.

LPMCI_DGV_SET_PARMS lParam2

Specifies a far pointer to the MCI_DGV_SET_PARMS data structure. This parameter replaces the standard default parameter data structure identified by lParam2.

Return Value

Returns zero if successful. Otherwise, it returns an MCI error code.