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>