MMProgRef - High-Level Macro Service 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 high-level macro service functions provide general playback and recording within a single function. These functions hide the programming overhead associated with playing and recording multimedia data, such as opening and closing a device, and simplify using multimedia capabilities in applications.

Note

mciPlayFile and mciPlayResource play different types of data (audio, video, MIDI, and so forth), however mciRecordAudioFile records only digital audio.

The high-level functions are listed in the following table.

Function	Description
mciPlayFile	Plays a multimedia file or audio elements of a compound file.
mciPlayResource	Plays a multimedia resource that has been bound into an application.
mciRecordAudioFile	Records digital audio into a file specified by the caller. Records **only** digital audio.

To use the 16-bit versions of mciPlayFile, mciPlayResource, and mciRecordAudioFile, 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_MACHDR
#define  INCL_16
#include <os2me.h>