武汉石化设计院电算室 周红汉

使用MCI API，源文件中需要包含头文件 Mmsystem.h，在Project->Settings->Link->Object/libray module中加入库 Winmm.lib。

１、MCI简介

　　MCI(Media Control Interface，媒体控制接口)向Windows程序提供了在高层次上控制媒体设备接口的能力。程序不必关心具体设备，就可以对激光唱机（CD）、视盘机、波形音频设备、视频播放设备和MIDI设备等媒体设备进行控制。
　　对于程序员来说，可以把MCI理解为设备面板上的一排按键，通过选择不同的按键（发送不同的MCI命令）可以让设备完成各种功能，而不必关心设备内部实现。
　　比如，对于play，视盘机和CD机有不同的反应（一个是播放视频，一个播放音频），而对用户来说却只需要按同一按钮。

　　应用程序通过向MCI发送命令来控制媒体设备。MCI命令接口分命令字符串和命令消息两种，两者具有相同的功能。命令字符串具有使用简单的特点，但是它的执行效率不如命令消息。

　　所有的MCI命令字符串都是通过多媒体API函数mciSendString传递给MCI的，该函数的声明为：
　　　　MCIERROR mciSendString(
　　　　　　LPCTSTR lpszCommand, 　　　//MCI命令字符串
　　　　　　LPTSTR　lpszReturnString,　//存放反馈信息的缓冲区
　　　　　　UINT　　cchReturn, 　　　　//缓冲区的长度
　　　　　　HANDLE　hwndCallback 　　　//回调窗口的句柄，一般为NULL
　　　　); //若成功则返回0，否则返回错误码。
　　该函数返回的错误码可以用mciGetErrorString函数进行分析，该函数的声明为：
　　　　BOOL mciGetErrorString(
　　　　　　DWORD　fdwError,　　　//函数mciSendString返回的错误码
　　　　　　LPTSTR lpszErrorText, //接收描述错误的字符串的缓冲区
　　　　　　UINT　 cchErrorText　 //缓冲区的长度
　　　　);

　　下面是使用mciSendString函数的一个简单例子：
　　　　char buf[50];
　　　　MCIERROR mciError;
　　　　mciError=mciSendString(“open cdaudio”,buf,strlen(buf),NULL);
　　　　if(mciError)
　　　　{
　　　　　　mciGetErrorString(mciError,buf,strlen(buf));
　　　　　　AfxMessageBox(buf);
　　　　　　return;
　　　　}
　　open cdaudio命令打开CD播放器，如果出错（如驱动器内没有CD）则返回错误码，此时可以用mciGetErrorString函数取得错误信息字符串。

２、MCI设备

　　open是MCI打开设备的命令，cdaudio是MCI设备名。MCI的设备类型如下：
　　　　animation　　动画设备
　　　　cdaudio　　　CD播放器
　　　　dat　　　　　数字音频磁带机
　　　　digitalvideo 某一窗口中的数字视频（不基于GDI）
　　　　other　　　　未定义的MCI设备
　　　　overlay　　　重叠设备（窗口中的模拟视频）
　　　　scanner　　　图象扫描仪
　　　　sequencer　　MIDI序列器
　　　　videodisc　　视盘机
　　　　waveaudio　　播放数字波形文件的音频设备

　　设备名是在注册表或SYSTEM.INI的[mci]部分定义的，典型的[mci]段如下：
　　　　[mci]
　　　　cdaudio=mcicda.drv
　　　　sequencer=mciseq.drv
　　　　waveaudio=mciwave.drv
　　　　avivideo=mciavi.drv
　　　　videodisc=mcipionr.drv
　　等号的左边是设备名，右边是对应的MCI驱动程序。当安装了新的MCI驱动程序时，系统要用不同的设备名来区分。

３、MCI命令

　　使用MCI设备一般包括打开、使用和关闭三个过程，常用的MCI命令有：
　　　　open　　　　打开设备
　　　　close　　　 关闭设备
　　　　play　　　　开始设备播放
　　　　stop　　　　停止设备的播放或记录
　　　　record　　　开始记录
　　　　save　　　　保存设备内容
　　　　pause　　　 暂停设备的播放或记录
　　　　resume　　　恢复暂停播放或记录的设备
　　　　seek　　　　改变媒体的当前位置
　　　　capacility　查询设备能力
　　　　info　　　　查询设备的信息
　　　　status　　　查询设备状态信息
　　MCI的大部分命令可以控制不同的媒体设备，但其中record和save命令并不是所有MCI设备都可以使用。
　　MCI命令的使用是很随意的，只要先打开，最后关闭，中间可以随意调用各种命令。

(1) open　打开设备

　　MCI设备使用前必须先打开，当然，使用后也必须要关闭，以免影响他人的使用。

　　open device_name type device_type alias device_alias
　　　　device_name　 　　　要使用的设备名，通常是文件名。
　　　　type device_type　　设备类型，例如waveaudio或sequencer，可省略。
　　　　alias device_alias　设备别名，指定后可在其他命令中代替设备名。

(2) play　开始设备播放

　　MCI设备打开后即可以播放，可使用设备名或别名。

　　play device_alias from pos1 to pos2 wait repeat
　　　　若省略from则从当前磁道开始播放，若省略to则播放到结束。
　　　　若指明wait则等到播放完毕命令才返回。
　　　　若指明repeat则会不停的重复播放。
　　　　若同时指明wait和repeat则命令不会返回，本线程产生堵塞，通常会引起程序失去响应。

(3) 播放CD

　　void CTttView::OnOpenCD()
　　{
　　　　mciSendString(“open cdaudio”,NULL,0,NULL);
　　　　mciSendString(“play cdaudio”,NULL,0,NULL);
　　);

　　void CTttView::OnStopCD()
　　{
　　　　mciSendString(“stop cdaudio”,NULL,0,NULL);
　　　　mciSendString(“close cdaudio”,NULL,0,NULL);
　　);

　　还可以：
　　　　pause cdaudio 　暂停播放。
　　　　resume cdaudio　继续被暂停的播放。
　　　　seek cdaudio to < 位置>　移动到指定磁道。
　　　　set cdaudio door open/closed　弹出或缩进CD盘。

(4) 播放多媒体文件

　　void CTttView::OnMyMenu()
　　{
　　　　mciSendString(“open myfolder\\tada.wav alias aa”,NULL,0,NULL);
　　或　mciSendString(“open myfolder\\flourish.mid alias aa”,NULL,0,NULL);
　　或　mciSendString(“open myfolder\\clock.avi alias aa”,NULL,0,NULL);
　　　　mciSendString(“play aa wait”,NULL,0,NULL);
　　　　mciSendString(“close aa”,NULL,0,m_hWnd);
　　);

(5) 录制声音

　　void CTttView::OnStartRecord()
　　{
　　　　mciSendString(“open new type waveaudio alias aa”,NULL,0,NULL);
　　　　mciSendString(“record aa”,NULL,0,NULL);
　　);

　　void CTttView::OnStopRecord()
　　{
　　　　mciSendString(“save aa c:\\aaa.wav wait”,NULL,0,NULL);
　　　　mciSendString(“close aa”,NULL,0,NULL);
　　);

４、MCI命令消息

　　到目前为止，我们使用的都是MCI命令字符串。可以发现，命令字符串具有简单易学的优点，但这种接口与C/C++的风格相去甚远，如果程序要查询和设置大量数据，那么用字符串的形式将很不方便。
　　MCI的命令消息接口提供了C语言接口，它速度更快，并且更能符合C/C++程序员的需要。

　　所有MCI命令消息都是通过mciSendCommand函数发送的，函数声明为：
　　　　MCIERROR mciSendCommand(
　　　　　　MCIDEVICEID wIDDevice, 　//设备的ID，在打开设备时不用该参数
　　　　　　UINT　　　　uMsg, 　　　//命令消息
　　　　　　DWORD 　　　fdwCommand, //命令消息的标志
　　　　　　DWORD 　　　dwParam 　　//指向包含命令消息参数的结构
　　　　); //若成功则返回0，否则返回错误码

　　命令消息uMsg与命令字符串是对应的，例如，open与MCI_OPEN完成的是一样的功能。
　　变量wDeviceID用来保存设备的ID，系统用ID来标识不同的设备，以保证命令发给正确的对象。

　　void CTttView::OnMyMenu()
　　{
　　　　MCI_OPEN_PARMS mciOpen;
　　　　UINT wDeviceID;
　　　　mciOpen.lpstrDeviceType = “avivideo”;
　　　　mciOpen.lpstrElementName = “myfolder\\clock.avi”;
　　　　mciSendCommand(0, MCI_OPEN, MCI_OPEN_ELEMENT, (DWORD)&mciOpen);
　　　　wDeviceID=mciOpen.wDeviceID;
　　　　MCI_PLAY_PARMS mciPlay;
　　　　mciSendCommand(wDeviceID, MCI_PLAY, MCI_WAIT, (DWORD)&mciPlay);
　　);

　　可以看出，用命令消息比用命令字符串要复杂的多，但它的执行效率高。
===============================================

—- 加入音乐是增强应用程序功能的所有方法中最简单的一个。几乎每个计算机游戏或多 媒体程序都以某种MIDI或CD音乐为背景。音乐可以使用户心情愉快；在合适的场合播 放恰当的音乐能够使程序员和他的VC++程序焕发光彩。

第一部分 MIDI的播放
—- 乐器数字化接口（MIDI）是由音乐界的一些大公司（包括生产电子音乐合成器的公司） 制订的一项协议，后来被计算机产业所采用并成为多媒体音乐文件的标准格式。MIDI文件 一般较小，对硬件设备的要求高。

—- 一、 原理

—- 虽然MicroSoft支持MIDI文件，然而Visual C++或MFC并没有创建任何组件来实现 这种支持，但是MicroSoft API提供了三种不同的方法来实现MIDI的播放：

MCI（The Media Control Interface）。这是最基本的方法，本文将详细讨论这种方法。

流缓冲器。这种格式允许应用程序为MIDI数据分配缓冲器。在需要精确控制MIDI播放的时候，流缓冲器将很有用处。

低级MIDI设备。需要完全控制MIDI数据的应用程序可以使用这种方法。
—- MCI可以通过mciSendCommand（）和mciSendString（）来完成，本文仅使用mciSendCommand（）函数。

—- 原型：DWORD mciSendCommand（UINT wDeviceID，UINT wMessage，DWORD dwParam1，DWORD dwParam2）；

参数： wDeviceID：接受消息的设备ID
wMessage：MCI命令消息
dwParam1：命令的标志位
dwParam2：所使用参数块的指针

—- 返值：调用成功，返回零；否则，返回双字中的低字存放有错误信息。

二MIDI的播放控制
—- 1． 打开设备

MCI_OPEN_PARMS OpenParms;
OpenParms.lpstrDeviceType =
(LPCSTR) MCI_DEVTYPE_SEQUENCER;//MIDI类型
OpenParms.lpstrElementName = (LPCSTR) Filename;
OpenParms.wDeviceID = 0;
mciSendCommand (NULL, MCI_OPEN,
MCI_WAIT | MCI_OPEN_TYPE |
MCI_OPEN_TYPE_ID | MCI_OPEN_ELEMENT,
(DWORD)(LPVOID) &OpenParms)

—- MCI设备ID指明打开了哪个设备，当发送了MCI_OPEN命令时，这个值在参数块中返回——应被保存备用。

—- 2． 关闭设备

mciSendCommand (m_wDeviceID, MCI_CLOSE, NULL, NULL);

—- 3． 播放

MCI_PLAY_PARMS PlayParms;
PlayParms.dwFrom = 0;
// 指定从什么地方（时间）播放
mciSendCommand (m_wDeviceID, MCI_PLAY,
MCI_FROM, (DWORD)(LPVOID)
&PlayParms))；

—- 4． 暂停

MCI_PLAY_PARMS PlayParms;
mciSendCommand (m_wDeviceID, MCI_PAUSE, 0,
(DWORD)(LPVOID) &PlayParms)；

—- 5． 停止

mciSendCommand (m_wDeviceID, MCI_STOP, NULL, NULL);

—- 6． 跳跃

* 跳转到任意地方
MCI_SEEK_PARMS SeekParms;
SeekParms.dwTo = (nMinute * 60 + nSecond) * 1000;
//跳转的目标时间，时间单位为毫秒
mciSendCommand (m_wDeviceID, MCI_SEEK, MCI_TO
| MCI_WAIT,(DWORD)(LPVOID)
&SeekParms)；
* 跳到文件头
mciSendCommand (m_wDeviceID, MCI_SEEK,
MCI_SEEK_TO_START, NULL);
* 跳到文件尾
mciSendCommand (m_wDeviceID, MCI_SEEK,
MCI_SEEK_TO_END, NULL);

—- 7． 查询当前信息

MCI_STATUS_PARMS StatusParms;
StatusParms.dwItem = MCI_SEQ_STATUS_DIVTYPE;
mciSendCommand (m_wDeviceID, MCI_STATUS,
MCI_WAIT | MCI_STATUS_ITEM,
(DWORD)(LPVOID) &StatusParms)；
返回信息存放于StatusParms.dwReturn中。
MCI_STATUS标志
MCI_STATUS_LENGTH 获得文件长度
MCI_STATUS_MODE 获得文件播放的当前状态
MCI_STATUS_POSITION 获得文件播放的当前位置
MCI_STATUS_TIME_FORMAT 获得当前的时间格式
MCI_SEQ_STATUS_DIVTYPE 判断文件是PPQN类型还是SMPTE类型
MCI_SEQ_STATUS_TEMPO 获得当前播放速度，PQRN类型，
此值为节拍/分，SMPTE类型，此值为祯/秒

—- 8． 设置时间格式及播放速度

MCI_SET_PARMS SetParms;
SetParms.dwTimeFormat = MCI_FORMAT_MILLISECONDS;
//设置时间单位为毫秒
mciSendCommand (m_wDeviceID,
MCI_SET, MCI_SET_TIME_FORMAT,
(DWORD)(LPVOID) &SetParms)；
MCI_SEQ_SET_TEMPO 设置播放速度，
PQRN类型，此值为节拍/分，
SMPTE类型，此值为祯/秒

第二部分 WAV文件的播放
—- 一、原理

—- MicroSoft API提供了三种不同的方法来实现WAV的播放：

PlaySound（）函数。它可以通过单行编码来播放Wave格式的声音。此函数有两个限制：必须将声音数据完整地载入物理内存；数据格式必须被所配置的某一音频驱动器支 持。根据经验，PlaySound（）适用于100K以下的文件。

MCI（The Media Control Interface），与上一章播放MIDI文件相似，可以播放100K 以上的文件。

低级Wave音频设备。用这些设备可以运行完全控制Wave数据的应用文件。
—- 二、 WAV文件播放控制

—- 因为同样使用MCI，与上一章相同，只列出不同的部分。

—- 1． 打开设备

—- 将MIDI的MCI_DEVTYPE_SEQUENCER 改为”waveaudio”

—- 2． 录音

MCI_RECORD_PARMS RecordParms;
mciSendCommand (m_wDeviceID, MCI_RECORD,
NULL, (DWORD)(LPVOID)
&RecordParms)；

—- 3． 保存录音

MCI_SAVE_PARMS SaveParms;
SaveParms.lpfilename = (LPCSTR) Filename;
mciSendCommand (m_wDeviceID, MCI_SAVE,
MCI_SAVE_FILE | MCI_WAIT,
(DWORD)(LPVOID) &SaveParms)；

第三部分 CD的播放
—- CD的独特优势在于，它由作曲家设计，并由音乐厂家生产。不同的计算机播放MIDI 文件时，声音效果也不一样，但是CD的声音效果总是相同的。高品质的音频对计算机用 户产生的效果会使你感到吃惊。 我们依然采用MCI播放CD，大部分的播放控制与前两部分相同，只列出不同的部分

—- 1． 开光驱门

mciSendCommand (m_wDeviceID, MCI_SET,
MCI_SET_DOOR_OPEN, NULL);

—- 2． 关光驱门

mciSendCommand (m_wDeviceID, MCI_SET,
MCI_SET_DOOR_CLOSED, NULL);

—- 3． 打开设备

将MIDI的MCI_DEVTYPE_SEQUENCER 改为MCI_DEVTYPE_CD_AUDIO

—- 4． 播放

—- 指定播放起点必须经过MCI_MAKE_TMSF(Track，Minute，Second，Frame)转化

—- 5． 查询当前信息

MCI_STATUS_CURRENT_TRACK 得到当前曲目
MCI_STATUS_LENGTH 得到CD或指定曲目长度
MCI_STATUS_MODE 得到驱动器的当前状态
MCI_STATUS_NUMBER_OF_TRACKS 得到CD曲目的数目
MCI_STATUS_POSITION 得到当前格式下的位置
MCI_STATUS_READY 检查设备是否就绪
MCI_STATUS_TIME_FORMAT 得到当前时间格式
MCI_STATUS_MEDIA_divSENT 检查以确认CD是否在驱动器内
MCI_CDA_STATUS_TYPE_TRACK 检查已确认某曲目是否为音频曲目

—- 注意：

使用MCI_STATUS_LENGTH参数查询CD 及曲目长度，返回值通过调用MCI_MSF_MINUTE（），MCI_MSF_SECOND（）转换为分、秒。

MCI_STATUS_POSITION参数返回值调用MCI_TMSF_TRACK（）, MCI_TMSF_MINUTE（）， MCI_TMSF_SECOND（），MCI_TMSF_FRAME才能得到当前的位置的道、分、秒、帧。
—- 6． 跳跃

—- 跳转的目标必须经过MCI_MAKE_TMSF(Track，Minute，Second，Frame)转化最好将上述三种格式分开建类，或做成动态连接库。在 Project– >Setting– >Link– >Object/library modules中加入winmm.lib，源程序中包含。

—- MCI调用简单，功能强大，可以满足日常多媒体编程的基本需要。但是，MCI一次只能播放一个文件，使用DirectSound技术可以实现八个以上WAV文件的同时播放。