MCI编程之mciSendCommand

MCI编程之 mciSendCommand 杂谈    
使用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第二篇mci (2007-02-01 04:28)


所属分类: 默认分类


文章标签: 无标签


 


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


---- 加入音乐是增强应用程序功能的所有方法中最简单的一个。几乎每个计算机游戏或多媒体程序都以某种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_PRESENT 检查以确认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文件的同时播放。