MMProgRef - MCI Functions

Reprint Courtesy of International Business Machines Corporation, © International Business Machines Corporation

Multimedia Programming Reference

Introduction What's New... MCI Functions High-Level Macro Service Functions Subsystem Messages Notification Messages MCI Command Messages String Commands Memory Playlist Commands Graphic Button Control Secondary Window Functions MMIO Functions MMIO Messages CODEC Messages DIVE Functions Real-Time MIDI Functions SPI Functions Data Stream State Table SMH Messages DDCMD Messages VSD Commands SHD Messages SHC Messages Data Types Types of MIDI Messages Multimedia Specification Overview Resource Interchange File Format Multimedia File Formats RIFF Compound Files and Elements - Sharing and Access Return Codes Notices Glossary

The media control interface provides services to applications for controlling devices in the multimedia environment. These services are available through either a procedural message interface (**mciSendCommand**) or an interpretive string interface (**mciSendString**).

The following additional services are available to an application:

• Sharing devices with other applications
• Grouping devices for synchronization, acquisition, and collective use.

The media control interface uses the following functions for sending messages to control multimedia devices.

Function	Description
mciGetDeviceID	Retrieves the device ID corresponding to the alias of a device.
mciGetErrorString	Fills the caller's buffer with the error code string.
mciQuerySysValue	Queries OS/2 multimedia system values.
mciSendCommand	Sends a command to a media control driver using flags and structures.
mciSendString	Sends a command to a media device driver using string buffers.
mciSetSysValue	Sets or alters system wide values such as the captioning flag or working path for temporary files.

Note

To use the 16-bit versions of mciGetDeviceID, mciSendString, and mciGetErrorString, define **INCL_16** in the source file using these functions. The 16-bit entry points provide 16-bit applications with the ability to use multimedia in the OS/2 environment. For example:

#define  INCL_MCIOS2
#define  INCL_16
#include <os2me.h>