Video Overlay Devices

Much of the digital-video command set also applies to video overlay devices. The command set enhances the video overlay command set included in the Windows 3.1 Software Development Kit. The enhancements include the ability to control audio and video effects. Video overlay devices are distinguished from digital video devices in that they have no workspace, they cannot play files, and they cannot record audio or video.

A separate syntax summary for overlay devices is provided in an appendex. Only the commands listed in this summary are recognized by overlay devices. Other comments in this document indicate slight differences between overlay and digital-video devices for individual commands.

Although not required, a single driver can provide both overlay and digital video functionality. A combination overlay and digital video driver must be installed with two separate entries in the [mci] section of the system.ini file. One entry uses the identifier "overlay" with an optional digit suffix. This lets the device detect that it is being opened as an overlay-only device. The other entry lets the device be opened as a digital-video device. As a digital-video device, it should use a documented identifier that allows applications to select the device by name.

For example, if a device supports a file format called "mympeg," it might document the digital-video identifier as "mympeg_video" and install the following entries in the [mci] section of the system.ini file:

[mci]

overlay=mympeg.drv

mympeg_video=mympeg.drv

An application uses the device for overlay functions by opening it as an overlay device: open overlay

An application uses the device for digital-video functions by opening it as a digital-video device. For example, it could use the command open name.dat type mympeg_video

The driver detects whether the device is opened for overlay-only functions or for digital-video functions by checking the wType field of the data structure sent with the MCI_OPEN_DRIVER message. If wType is set to MCI_DEVTYPE_OVERLAY, the device should only respond to overlay commands and reject an attempt to open the device as a compound device.

If wType is set to MCI_DEVTYPE_DIGITAL_VIDEO or MCI_DEVTYPE_OTHER, the device should function as a digital-video device. If opened as a simple device, the device should respond only to capability and info commands. If opened as a compound device, the device responds to the entire command set.