简介面向希望在MFC与VC6.0环境中掌握多媒体控件集成的开发者这份基于MCIWnd的AVI视频播放器工程给出了一套可直接参考的完整实现通过“文件—打开”选择AVI文件后程序在客户区左上角创建MCIWnd窗口并显示视频首帧用户可借助窗口控制条中的播放按钮开始播放。RAR压缩包共39个文件约2.04MB主要由cpp与h源码、obj与pdb调试中间文件、ico与bmp图标位图、rc资源脚本以及dsp/dsw工程配置文件构成并附带exe可执行程序便于对照编译结果与工程结构。代码按文档、视图、主框架和子框架等MFC模块组织适合学习MCIWnd窗口嵌入、AVI加载与首帧呈现、菜单命令响应、资源脚本组织及VC6工程构建方式也能观察MCI多媒体接口与MFC文档视图架构的配合。已有134人学习下载可作为多媒体播放器入门的工程范例。1. 给工控上位机嵌一块能播 AVI 的窗口第一反应往往是拉 DirectShow 或者塞解码库。我去年在离线老设备上试过光 COM 初始化和滤镜图就两百行。最后落地的方案反直觉不引第三方依赖用系统自带 MCIWnd 窗口类注册、创建、把文件路径塞进去画面就出来了。基于 MCIWnd 的 AVI 视频播放器就是干这个的它把 MCI 命令字符串那层壳包成标准窗口类播放条、进度、暂停、音量、拖动定位都是现成的代价是只认系统 VFW 框架能解的编码。适合谁给工控上位机、老 MFC 项目、教学演示加一块视频区或者需要一个两三百行就能跑起来、不挑运行环境的播放组件。不适合做商业播放器格式覆盖撑不住。2. 技术选型与工程结构一个窗口类撑起的播放器MCIWnd 不是一个库而是 VFW 提供的一个预置窗口类类名固定为MCIWndClass窗口过程里把mciSendString那套字符串命令全包好了。你发MCIWndPlay宏它内部转成MCIWNDM_PLAY消息投给自己的窗口过程再翻译成play alias交给 MCI 设备驱动。理解这一层后面所有的坑都能对上号你操作的不是一个播放器对象而是一个窗口。2.1 三条路线的取舍MCIWnd、DirectShow 与解码库选型阶段我把三条路都写了原型结论写在表里。方案集成成本运行依赖格式覆盖适合的场景MCIWnd引入vfw.h链接vfw32.lib几十行起系统自带无需额外 DLL依赖本机 VFW 解码器AVI 稳MP4/MKV 基本没戏内嵌小窗、老项目、离线机器DirectShowCOM 初始化 滤镜图搭建几百行起系统组件新版系统部分解码器被拆走广需要逐帧控制、多格式第三方解码库编译链、体积、授权都要考虑自带 DLL最广商业播放器、格式兼容要求高这个项目的约束很明确机器离线、部署包不能带额外 DLL、只需要播 AVI。MCIWnd 正好卡在这个交集里。它的窗口类内部维护着 MCI 设备句柄、时间格式、播放状态还自带一个播放条子窗口你连按钮都不用画。2.2 工程目录与模块边界工程按「外壳 / 封装 / 资源」切三块我不喜欢把所有东西堆进main.cpp因为后期换播放内核时会被绑死。文件职责src/main.cpp入口、父窗口类注册、消息循环、菜单命令分发src/player.h对外接口Open / Play / Pause / Stop / Seek / GetProgresssrc/player.cppMCIWnd 的创建、打开片源、状态查询、错误转文本res/player.rc菜单、图标、进度条对话框模板res/resource.h命令 ID 与控件 IDbuild.bat一键编译脚本player.cpp是关键的一层隔离。它对外只暴露普通函数内部持有g_hMci这个子窗口句柄。以后真到了格式不支持、必须换 DirectShow 的那天改的是这一个文件main.cpp里的调用一行不用动。这是我在老项目上踩出来的习惯凡是可能被替换的第三方能力都别让它长到业务代码里。2.3 运行时结构一条命令从菜单到画面的路径整个链路是两段式父窗口负责界面与输入MCIWnd 子窗口负责解码与呈现。正向路径是这样的用户点「播放」→ 父窗口收到WM_COMMAND→ 调封装层的Player_Play()→ 宏展开成SendMessage(g_hMci, MCIWNDM_PLAY, ...)→ MCIWnd 的窗口过程收到消息 → 内部拼出play avialias字符串 → 通过 MCI 接口下发给AVIVideo设备 → VFW 解码器解帧 → 画到 MCIWnd 的客户区。反向路径同样重要。解码器状态变化时MCIWnd 的窗口过程会把通知消息直接SendMessage给父窗口比如MCIWNDM_NOTIFYMODE播放状态变了、MCIWNDM_NOTIFYPOS位置变了、MCIWNDM_NOTIFYSIZE画面尺寸变了、MCIWNDM_NOTIFYERROR出错了。这些消息落在父窗口的窗口过程里和WM_COMMAND平级不设样式就收不到。很多「进度条不动」的问题根子就在创建时忘了加MCIWNDF_NOTIFYPOS。提示MCIWndGetDeviceID能拿到底层 MCI 设备 ID调试时打印出来配合错误码基本能定位到是设备没打开还是命令不认。3. 从零跑通几十行代码让 AVI 出现在窗口里这一章的目标是「按顺序抄完就能出画面」。不需要对话框资源不需要 MFC纯 Win32 加一个菜单就够。3.1 环境准备与链接项需要 Visual Studio 的「使用 C 的桌面开发」组件头文件vfw.h库vfw32.lib。工程属性里两个地方必须对一是字符集统一设为 Unicode。MCIWnd 的打开接口在宽字符下走的是MCIWndOpen的宽字符版本混用 ANSI 会在中文路径上直接翻车这个后面避坑章节会细说。二是链接器附加依赖项里补上vfw32.lib user32.lib comdlg32.lib comctl32.lib。前三者是播放与文件对话框comctl32.lib是进度条控件用的。不想开 IDE 的话命令行一样能编:: 在 x64 Native Tools Command Prompt 里执行工作目录为工程根 rc /fo player.res res\player.rc cl /nologo /EHsc /W3 /DUNICODE /D_UNICODE /MD ^ src\main.cpp src\player.cpp player.res ^ /link /SUBSYSTEM:WINDOWS ^ user32.lib gdi32.lib comdlg32.lib comctl32.lib vfw32.lib/DUNICODE /D_UNICODE这两个宏决定TCHAR展开成wchar_t别省。/SUBSYSTEM:WINDOWS表示入口是wWinMain而不是控制台的main。rc那一步生成.res链接时把它和.obj一起丢进去菜单才存在。3.2 最小可运行骨架注册、创建、塞路径先注册父窗口类再显式注册一次 MCIWnd 窗口类然后进消息循环。// src/main.cpp —— 入口与主窗口骨架 #include windows.h #include commdlg.h #include vfw.h #include player.h LRESULT CALLBACK WndProc(HWND, UINT, WPARAM, LPARAM); int WINAPI wWinMain(HINSTANCE hInst, HINSTANCE, PWSTR, int nCmdShow) { // 显式注册 MCIWnd 窗口类别指望后面裸调 CreateWindow 能成功 if (!MCIWndRegisterClass()) return 0; WNDCLASSEXW wc { sizeof(wc) }; wc.lpfnWndProc WndProc; wc.hInstance hInst; wc.hCursor LoadCursor(NULL, IDC_ARROW); wc.hbrBackground (HBRUSH)(COLOR_WINDOW 1); wc.lpszClassName LPlayerFrame; wc.lpszMenuName MAKEINTRESOURCEW(IDR_MAINMENU); // 来自 .rc RegisterClassExW(wc); HWND hWnd CreateWindowExW(0, LPlayerFrame, LAVI 播放器, WS_OVERLAPPEDWINDOW, CW_USEDEFAULT, CW_USEDEFAULT, 880, 620, NULL, NULL, hInst, NULL); ShowWindow(hWnd, nCmdShow); UpdateWindow(hWnd); MSG msg; while (GetMessageW(msg, NULL, 0, 0) 0) // 注意 0-1 要退出 { TranslateMessage(msg); DispatchMessageW(msg); } return (int)msg.wParam; }MCIWndRegisterClass()这一步别省。它把MCIWndClass注册进当前进程之后MCIWndCreate内部才有类可用。GetMessageW的返回值判断写成 0是血泪经验写成! 0会在收到WM_QUIT之外的 -1 错误时死循环。接下来是打开文件并创建 MCIWnd 子窗口// src/player.cpp —— 打开片源与创建子窗口 #include windows.h #include commdlg.h #include vfw.h #include player.h static HWND g_hMci NULL; void Player_Open(HWND hParent) { wchar_t szFile[MAX_PATH] L; OPENFILENAMEW ofn { sizeof(ofn) }; ofn.hwndOwner hParent; ofn.lpstrFilter LAVI 视频\0*.avi\0所有文件\0*.*\0; ofn.lpstrFile szFile; ofn.nMaxFile MAX_PATH; ofn.Flags OFN_FILEMUSTEXIST | OFN_PATHMUSTEXIST; if (!GetOpenFileNameW(ofn)) return; // 用户取消 if (g_hMci NULL) { // 首次创建带播放条、带文件名/位置/状态显示并打开三个通知 g_hMci MCIWndCreate(hParent, GetModuleHandleW(NULL), WS_CHILD | WS_VISIBLE | MCIWNDF_SHOWALL // 播放条 文件名 位置 状态 | MCIWNDF_NOTIFYPOS // 位置变化通知父窗口 | MCIWNDF_NOTIFYMODE // 播放状态变化通知 | MCIWNDF_NOTIFYERROR // 出错通知 | MCIWNDF_NOERRORDLG, // 错误自己弹别让系统弹模态框 szFile); } else { MCIWndOpen(g_hMci, szFile, 0); // 复用窗口换片源省一次创建开销 } }MCIWndCreate的参数依次是父窗口、实例句柄、窗口样式、文件路径。样式位是这块的核心MCIWNDF_SHOWALL等价于把SHOWNAME | SHOWPOS | SHOWMODE和播放条一起打开NOERRORDLG很实用默认情况下播放失败会弹一个系统模态框嵌在上位机界面里非常难看关掉之后错误通过MCIWNDM_NOTIFYERROR回到你自己的窗口过程想怎么提示自己决定。传了文件路径的MCIWndCreate会顺手完成打开动作不需要再单独调一次MCIWndOpen。这一点容易写重复重复打开同一个文件在某些解码器上会返回MCIERR_CANNOT_LOAD_DRIVER。3.3 尺寸同步与销毁顺序MCIWnd 子窗口不会自动跟着父窗口走得自己搬。另外销毁顺序搞反会崩。// 主窗口过程中的两段关键处理 case WM_SIZE: if (g_hMci) MoveWindow(g_hMci, 0, 0, LOWORD(lParam), HIWORD(lParam), TRUE); break; case WM_DESTROY: Player_Close(); // 内部只调一次 MCIWndDestroy PostQuitMessage(0); break;MoveWindow最后一个参数传TRUE触发重绘省得拉伸时出现白块。Player_Close()内部实现就是一行void Player_Close() { if (g_hMci) { MCIWndDestroy(g_hMci); g_hMci NULL; } }MCIWndDestroy一个函数干三件事停播、关设备、销毁窗口。所以后面别再补一句DestroyWindow(g_hMci)句柄已经失效轻则断言失败重则访问违例。这是我在调试版上没复现、发布版上偶发崩溃的经典原因。4. 核心模块拆解播放控制、进度同步与错误回调外壳跑通之后真正要做的是把交互做顺。这一章拆三个模块命令映射、进度同步、错误处理。4.1 控制命令映射菜单项到 MCI 的直译MCIWnd 的每个宏都对应一条 MCI 字符串命令理解对应关系出问题时就知道该查哪一层。界面动作调用底层 MCI 命令播放MCIWndPlay(h)play alias从当前位置播到指定点MCIWndPlayTo(h, pos)play alias to pos暂停MCIWndPause(h)pause alias停止MCIWndStop(h)stop alias回到开头MCIWndHome(h)seek alias to start跳到末尾MCIWndEnd(h)seek alias to end定位MCIWndSeek(h, pos)seek alias to pos设置音量MCIWndSetVolume(h, v)setaudio alias volume to v菜单命令的分发这样写case WM_COMMAND: switch (LOWORD(wParam)) { case IDM_OPEN: Player_Open(hWnd); break; case IDM_PLAY: if (g_hMci) { // 播到结尾后状态仍是 MCI_MODE_STOP直接 Play 不会重播 if (MCIWndGetMode(g_hMci, NULL, 0) MCI_MODE_STOP) MCIWndHome(g_hMci); // 先回起点 MCIWndPlay(g_hMci); } break; case IDM_PAUSE: if (g_hMci) MCIWndPause(g_hMci); break; case IDM_STOP: if (g_hMci) { MCIWndStop(g_hMci); MCIWndHome(g_hMci); } break; } break;MCIWndGetMode的第二个参数是接收模式字符串的缓冲区传NULL就只取返回值。MCI_MODE_STOP这个判断是这段代码里最有价值的一行不加它用户播完一遍再点播放界面毫无反应看起来像卡死。IDM_STOP里补一句MCIWndHome是我的习惯停止即归零符合大多数人的直觉。4.2 进度条与时间格式先定单位再谈同步MCIWnd 的时间单位是可以切换的切换之前MCIWndGetLength和MCIWndGetPosition返回的数值含义完全不同这是最容易写错的地方。// 打开成功后立刻定单位整个生命周期内不要再改 MCIWndUseTime(g_hMci); // 后续 Length/Position 单位都是毫秒 // 如果要做逐帧步进改成帧单位 // MCIWndUseFrames(g_hMci);进度同步用定时器拉比等通知更稳。通知是事件驱动的拖动或暂停时不一定持续触发而进度条需要匀速刷新。// 播放开始时启动SetTimer(hWnd, TIMER_PROGRESS, 200, NULL); case WM_TIMER: if (wParam TIMER_PROGRESS g_hMci) { LONG len MCIWndGetLength(g_hMci); // 总长毫秒 LONG pos MCIWndGetPosition(g_hMci); // 当前位置毫秒 if (len 0) { SendDlgItemMessageW(hWnd, IDC_PROGRESS, PBM_SETRANGE32, 0, len); SendDlgItemMessageW(hWnd, IDC_PROGRESS, PBM_SETPOS, pos, 0); // 顺便刷时间文本mm:ss / mm:ss Player_UpdateTimeLabel(hWnd, pos, len); } } break;200 毫秒是刷 UI 的常用间隔再快人眼也分辨不出反而占 CPU。PBM_SETRANGE32支持 32 位范围长视频的毫秒数会超过 65535用 16 位的PBM_SETRANGE会溢出成负数进度条直接不动。这个坑我踩过一次排查了半天以为是长度取错了。拖动进度条跳转时先暂停再定位再恢复void Player_SeekTo(HWND hMci, LONG ms) { BOOL wasPlaying (MCIWndGetMode(hMci, NULL, 0) MCI_MODE_PLAY); if (wasPlaying) MCIWndPause(hMci); MCIWndSeek(hMci, ms); if (wasPlaying) MCIWndPlay(hMci); }MCI_MODE_PLAY是播放中的状态值同理还有MCI_MODE_PAUSE、MCI_MODE_STOP、MCI_MODE_SEEK。有些解码器在定位过程中会短暂进入MCI_MODE_SEEK所以暂停判断只认PLAY别写反。4.3 通知消息与错误处理把黑匣子撬开MCIWnd 出错时默认只弹框或者干脆没反应不打印错误码的话基本没法查。三个通知消息要接住。// 父窗口过程中和 WM_COMMAND 平级 case MCIWNDM_NOTIFYMODE: // lParam 为当前模式例如 MCI_MODE_STOP / MCI_MODE_PLAY if ((LONG)lParam MCI_MODE_STOP) KillTimer(hWnd, TIMER_PROGRESS); break; case MCIWNDM_NOTIFYSIZE: { // 换片源后画面原始尺寸可能变了把父窗口调到合适大小 RECT rc; MCIWndGetSource(g_hMci, rc); // 视频源区域 LONG w rc.right - rc.left; LONG h rc.bottom - rc.top; if (w 0 h 0) SetWindowPos(hWnd, NULL, 0, 0, (int)w 16, (int)h 96, // 预留菜单与边框 SWP_NOMOVE | SWP_NOZORDER); break; } case MCIWNDM_NOTIFYERROR: { wchar_t szErr[256] L; LONG code MCIWndGetError(g_hMci, szErr, sizeof(szErr) / sizeof(wchar_t)); wchar_t szMsg[512]; wsprintfW(szMsg, LMCI 错误 %ld%s, code, szErr); OutputDebugStringW(szMsg); // 调试器里直接看 break; }MCIWndGetError三个参数分别是窗口句柄、接收文本的缓冲、缓冲长度字符数不是字节数返回值是数值错误码。MCIWndGetSource拿到的是视频原始画面区域用它在换片时调整窗口大小比硬编码 800×600 靠得住。注意MCIWNDM_NOTIFYSIZE只在画面尺寸真的变化时才发第一次打开文件不一定会触发。首帧尺寸要在打开成功后主动取一次别只依赖通知。5. 避坑与排查报错不多但就是不播的几种情况MCIWnd 的调试体验一般很多失败没有明确提示只表现为黑屏、静默、或者界面按钮点了没反应。下面这几条是实际调试记录。5.1 打不开与没画面现象MCIWndCreate返回了有效句柄窗口也出来了但客户区一片黑进度条停在 0播放按钮点了也没动静。原因AVI 只是个容器里面装的是哪种编码由文件决定。AVIVideo设备最终交给 VFW 的解码器去解机器上没有对应解码器就解不了。有些早期采集设备导出的 AVI 用了私有编码在开发机上能放装了采集卡驱动拿到干净的生产机上就是黑屏。解决先用MCIWndCanPlay(hMci, szFile)在打开前预判一次返回 FALSE 就别打开直接给用户提示再准备一个标准 MJPEG 或未压缩 RGB 的 AVI 做对照样本能放对照样本说明是编码问题不是代码问题。另外把MCIWndGetError的返回值打进日志MCIERR_UNSUPPORTED_FUNCTION和MCIERR_INVALID_FILE指向完全不同的方向。5.2 播放状态不听话现象播完一遍后点播放没反应或者暂停之后再点播放画面从头开始放。原因前者是状态停在MCI_MODE_STOP但位置在末尾play命令从末尾开始自然什么都播不出来后者是代码里没区分「暂停恢复」和「停止重播」全用同一个MCIWndPlay。解决播放前判断模式和位置末尾就MCIWndHome回零暂停恢复用MCIWndResume而不是MCIWndPlay两个函数的语义不一样。如果做循环播放直接MCIWndSetRepeat(hMci, TRUE)让驱动层自己处理别在定时器里手动 seek。现象中文目录下的 AVI 打不开英文路径正常。原因工程用了 ANSI 字符集OPENFILENAME走的是窄字符版本从对话框拿到的路径在转宽字符时编码丢失。解决整个工程统一UNICODEGetOpenFileNameW、MCIWndOpen宽字符版一路到底中间不要出现char和wchar_t互转。5.3 窗口布局与销毁顺序现象窗口拖大后视频画面还挤在左上角一小块或者播放条被父窗口裁掉半截。原因MCIWnd 有自己的一套自动尺寸逻辑收到MCIWNDM_NOTIFYSIZE时会调整自身窗口大小以匹配视频原始比例这跟父窗口的布局逻辑打架。解决创建时加MCIWNDF_NOAUTOSIZEWINDOW把尺寸控制权收回父窗口只保留MCIWNDM_NOTIFYSIZE通知用于取宽高比布局统一在WM_SIZE里MoveWindow别两边都改。现象关闭主窗口时偶发崩溃调试版不复现。原因MCIWndDestroy之后又调了DestroyWindow或者父窗口析构时子窗口还在解码线程里跑。解决销毁只留一个出口MCIWndDestroy一次到位句柄置 NULLWM_CLOSE里先MCIWndStop再走默认流程保证解码停了才关窗口。6. 二次开发把它改成自己的播放器最后一层是外观和能力的改造。MCIWnd 自带播放条长得像九十年代的控件嵌进现代界面很违和去掉它自己画是最常见的需求。// 运行时切换样式去掉播放条和右键菜单 LONG styles MCIWndGetStyles(g_hMci); styles | MCIWNDF_NOPLAYBAR | MCIWNDF_NOMENU; styles ~MCIWNDF_SHOWALL; MCIWndChangeStyles(g_hMci, MCIWNDF_NOPLAYBAR | MCIWNDF_NOMENU | MCIWNDF_SHOWALL, 0);MCIWndChangeStyles的第二个参数是掩码第三个是值语义跟SetWindowLong改样式一致。注意要同时把SHOWALL里的位清掉只加NOPLAYBAR有时不生效因为SHOWALL已经把播放条的位置上了。缩放和全屏靠MCIWndSetZoom与父窗口样式切换MCIWndSetZoom(hMci, 100)是原始大小200是两倍。全屏我一般不动 MCIWnd 自身而是把父窗口改成无边框WS_POPUP铺满屏幕子窗口跟随WM_SIZE撑满退出时还原原样式并记一个WINDOWPLACEMENT。这条路比给 MCIWnd 发全屏消息稳因为 MCIWnd 不认全屏这个概念。判断什么时候该放弃它我有个简单的验证清单需要播 MP4/MKV、需要精确到帧的逐帧步进、需要多路视频同屏、需要截图导出无损帧——四条里命中任意一条就换 DirectShow 或第三方库。截图这条尤其明显MCIWnd 没有取帧接口从窗口 DC 上BitBlt在硬件覆盖模式下拿到的常常是一片黑。从那以后我每次给老项目加视频能力都强制先跑一遍「对照样本 错误码打印 干净机器验证」这三步再谈界面。希望帮到你。本文还有配套的精品资源点击获取
