基本介紹
- 中文名:mciSendString
- 頭檔案:#include <mmsystem.h>
- 使用指南:播放多媒體檔案的API指令
- 功能:播放MPEG,AVI,WAV,MP3,MID,
頭檔案,函式原型,使用方法,程式示例,
頭檔案
#include <mmsystem.h>
函式原型
mciSendString(傳送命令串),函式原型為:
MCIERROR mciSendString( // 出錯返回非零值(錯誤代碼)
// 可用mciGetErrorString獲得錯誤的文本描述
LPCTSTR lpszCommand, // 指向以null結尾的命令字元串:”命令 設備[ 參數]”
LPTSTR lpszReturnString,// 指向接收返回信息的緩衝區,為NULL時不返回信息
UINT cchReturn, // 上述緩衝區的大小
HANDLE hwndCallback // 在命令串中含notify時,它指定一個回調視窗的句柄
// 一般為NULL
);
如:mciSendString(L"open sample.wav type waveaudio alias wave", NULL, 0, NULL);
MCI函式中還有一個只適用於命令串接口的函式為mciExcute,mciExcute(執行)是mciSendString的簡化形式:
BOOL mciExcute(LPCTSTR lpszCommand); // 成功返回TRUE
該函式只有Win16支持,Win32不支持,可自寫一函式實現:
BOOL mciExcute(LPCTSTR lpszCommand) {
if (mciSendString(lpszCommand, NULL, 0, NULL)) return FALSE;
return TRUE;
}
如:mciExcute(L"open sample.wav type waveaudio alias wave");
使用方法
一,打開多媒體檔案。
首先在Dialog上面放一個Picture控制項,MCISendString就在這個Picture控制項的平面上播放多媒體檔案,
設Picture控制項的ID為IDC_STATIC1:
CString open1;
char buf[256];
open1.Format("open f:\\mpeg\\mpeg1.avi type MPEGVideo Alias movie parent %u Style %u notify", h,WS_CHILD);
mciSendString(open1.GetBuffer(open1.GetLength()),buf,sizeof(buf),NULL);
這樣F盤下面的mpeg目錄下的mpeg1.avi就打開了,其中的type MPEGVideo是指打開MPEG,AVI等類型,如果不加type MPEGVideo這一句,就是打開WAV,MP3等,Alias movie定義了mpeg1.avi的別名為movie,以後可以通過操作movie就可以操作mpeg1.avi。
二,播放多媒體檔案。
上面我們已經打開了f:"mpeg"mpeg1.avi,現在我們來播放它:
mciSendString("play movie",buf,sizeof(buf),NULL);
如果想全螢幕播放:
mciSendString("play movie fullscreen",buf,sizeof(buf),NULL);
三,暫停播放。
mciSendString("pause movie",buf,sizeof(buf),NULL);
四,停止播放。
mciSendString("close movie",buf,sizeof(buf),NULL);
五,得到所播放檔案的長度。
char sPosition[256];long lLength;
mciSendString("Status movie length", sPosition, 255,0);lLength=strtol(sPosition, NULL, 10);
其中lLength就是所播放檔案的長度。注意:該長度單位是毫秒。
六,得到所播放檔案的聲音大小。
char chVolume[256];long lVolume;mciSendString("status movie volume",chVolume,255,0);lVolume=strtol(chVolume,NULL,10);其中lVolume就是所播放檔案的聲音大小。
七,到你指定的位置播放。
CString step1;long lPosition;
lPosition=100;
step1.Format("seek movie to %ld",lPosition);
mciSendString(step1.GetBuffer(step1.GetLength()),buf,sizeof(buf),0);
其中lPosition就是要到的播放位置,可以由你指定。
程式示例
命令串
1)CD
wchar_t buf[256];
MCIERROR err = mciSendString(L"open cdaudio alias cd", NULL, 0, NULL); // 打開CD
if (err) {
if (mciGetErrorString(err, buf, 256))
MessageBox(buf, L"Error"); // 獲得並顯示錯誤串
return;
}
mciSendString(L"status cd number of tracks", buf, 256, NULL); // 獲得音軌總數
m_nTracks = wcstol(buf, NULL, 10); // 這裡使用了寬字元版的字元串到整數的
wsprintf(buf, L"play cd from %d to %d", m_nFrom, m_nTo);
mciSendString(buf, NULL, 0, NULL); // 從音軌m_nFrom頭播放到音軌m_nTo–1尾
其他常用命令:
mciSendString(L"set cd time format tmsf", NULL,0,NULL); // 設定時間格式為
// 軌(<100):分(<100):秒(<60):幀(<75),一秒=75塊,一塊=98幀
mciSendString(L"set cd door open", NULL, 0, NULL); // 打開光碟機
mciSendString(L"set cd door closed", NULL, 0, NULL); // 關閉光碟機
mciSendString(L"pause cd", NULL, 0, NULL); // 暫停播放
mciSendString(L"resume cd", NULL, 0, NULL); // 恢復播放
mciSendString(L"stop cd", NULL, 0, NULL); // 停止播放
mciSendString(L"close cd", NULL, 0, NULL); // 關閉CD設備
mciSendString(L"status cd length", buf, 256, NULL); // 獲得整個CD的音軌總長度
mciSendString(L"status cd length track 5", buf, 256, NULL); // 獲得第5個音軌的長度
mciSendString(L"status cd current track", buf, 256, NULL); // 獲得當前音軌號
注意:
"play cd from m_nFrom to m_nTo"是完整形式,它還有其他形式:
"play cd from m_nFrom"從m_nFrom播放到盤尾
"play cd to m_nTo"從當前位置播放到指定音軌
"play cd" 從當前位置播放到盤尾
例如播放最後一首歌:"play cd from m_nLast"
2)WAV
wchar_t buf[256];
wsprintf(buf, L"open \"%s\" alias sound type waveaudio", pDoc->strFilePath);
if (err) {
if (mciGetErrorString(err, buf, 256)) MessageBox(buf, L“Error”);
return;
}
// t1和t2為用戶指定的起止時間(單位為秒,浮點變數)
DWORD start = (DWORD)(t1 * 1000 + 0.5), end = (DWORD)(t2 * 1000 + 0.5);
wsprintf(buf, L"play sound from %ld to %ld", start, end);
mciSendString(buf, NULL, 0, NULL);
其他常用命令:
mciSendString(L"status sound length", buf, 256, NULL);
mciSendString(L"pause sound", NULL, 0, NULL);
mciSendString(L"play sound", NULL, 0, NULL); // 從當前位置播放到檔案尾
mciSendString(L"stop sound", NULL, 0, NULL);
mciSendString(L"close sound", NULL, 0, NULL);
3).MP3
下面看一個播放mp3音樂的簡單示例:
#include<windows.h>#include<mmsystem.h>#pragma comment(lib,"WINMM.LIB")intmain(intargc,char*argv[]){mciSendString(TEXT("open 難忘的一天.mp3 alias mysong"),NULL,0,NULL);mciSendString(TEXT("play MySong"),NULL,0,NULL);Sleep(50000);return0;}
該函式還可以播放avi視頻等。