用MCIWnd四十行代码实现Win32 AVI播放器

简介这是一份基于 MCIWnd 的 AVI 视频播放器示例工程面向正在学习 MFC 多媒体编程、需要理解 MCIWnd 控件用法的开发者。工程实现通过“文件→打开”选择 AVI 文件在客户区左上角创建 MCIWnd 窗口并显示首帧画面点击控制条播放按钮即可开始播放适合作为课程设计、控件练习或小型播放器原型参考。压缩包为 rar 格式共 39 个文件、约 2.04MB包含 h/cpp 源码、obj 与 exe 构建产物、rc 资源、图标和工具栏位图以及 MFC 文档/视图、主框架和子框架相关代码目录结构保留单文档工程常见模块便于直接运行并对照修改。当前已有 134 人学习。读者可从中了解 MCIWnd 窗口的创建与消息处理、AVI 文件打开流程、MFC 资源组织方式并借助现有工程结构快速搭建自己的视频播放功能也可据此排查编译、资源加载和播放控制中的常见问题。1. 为什么还要开发 MCIWnd用四十行代码换一个 AVI 播放器要在 Win32 窗口里放一段 AVI引入第三方解码库往往从几十兆起步编译链、依赖和分发方式也得跟着改。这时候回头看 MCIWnd一个注册好就能用的窗口类四十来行代码就能得到一个带播放条、能拖进度、能读时长的 avi 视频播放器。它的边界同样明显——解码全部交给系统里已注册的 VfW 解码器放不出来的格式你几乎无能为力这一点必须先接受再动手。下面按机制、骨架、控制、踩坑、进阶嵌入的顺序走一遍从建工程、链接 vfw32.lib到 64 位进程加载不了 32 位解码器这种常见失败点都落到具体代码和参数上。适合要快速交付轻量播放器演示的开发者也适合接手十几年前 MCI 老代码、只想先把画面弄出来的人。2. MCIWnd 的三层结构窗口类、MCI 命令与 VfW 解码器2.1 你写的代码只碰最上面那层把 MCIWnd 当成一个普通窗口类看待理解起来就顺了它有窗口过程、有自己的默认控制条播放、停止、进度、右键菜单MCIWndCreate返回的就是个 HWND。区别在于它的窗口过程不画像素而是把按钮点击、拖动滑块、菜单选择翻译成一条条 MCI 命令字符串比如play from 0 to 3000、seek to 1200、set time format ms然后丢给 MCI 子系统。MCI 子系统拿到命令后再按设备类型分发。AVI 走的是digitalvideo这一类设备最终由 Video for Windows 那套编解码器完成解封装、解码、颜色空间转换和声音输出。所以整条链路是三段MCIWnd 负责界面和命令翻译MCI 负责命令解析与设备调度VfW 解码器负责真正把压缩帧还原成 RGB 数据。这三段里第一段你能改第二段基本只能发命令第三段完全取决于目标机器装了什么。理解这一点后面所有「为什么同一份代码在我机器上能播、在客户机器上黑屏」的疑问都有了解释方向。血泪经验是定位问题时先分清是哪一层出的错MCIWndGetError拿到的是 MCI 层的报错原文如果它返回空但画面还是黑的问题多半在第三段。2.2 头文件、导入库和真正用得上的 API工程里只需要两步包含vfw.h链接vfw32.lib。注意包含顺序vfw.h依赖windows.h里的基础类型必须放在后面否则会冒出一堆类型未定义的错误。这也是很多人在新工程里第一次用 MCIWnd 时遇到的问题。// 头文件顺序不能反vfw.h 依赖 windows.h 里的基础类型 #include windows.h #include vfw.h // 二选一写这句或者在工程属性 - 链接器 - 输入里加 vfw32.lib #pragma comment(lib, vfw32.lib)vfw32.lib是导入库32 位和 64 位工程同名链接器会按目标平台自动挑对应的那份这一点不用手动区分。真正要区分的在运行时后面第五节会讲到。下面的 API 是实际项目里覆盖率最高的先建立整体印象再写代码会快很多调用作用返回值要点MCIWndRegisterClass注册 MCIWnd 窗口类必须在创建任何播放器窗口前调一次MCIWndCreate创建播放器窗口返回 HWND失败为 NULL可同时指定文件MCIWndOpen打开媒体文件MCI 惯例返回 0 表示成功MCIWndPlay/MCIWndPause/MCIWndStop播放、暂停、停止失败返回非 0MCIWndSeek定位到指定位置位置单位取决于当前时间格式MCIWndGetLength取总长度单位随时间格式变化MCIWndGetPosition取当前位置同上MCIWndSetTimeFormat切换时间格式传ms或framesMCIWndGetError取 MCI 层错误文本注意缓冲是char与工程字符集无关MCIWndClose/MCIWndDestroy关闭设备 / 销毁窗口Destroy内部已包含关闭提示MCIWndOpen的返回值语义和 Win32 大部分 API 相反0 才是成功。这一点我在老代码里见过不止一次写成if (MCIWndOpen(...)) { 报错 }结果能播的时候反而弹窗。几乎所有MCIWnd*函数底层都是往播放器窗口发一条MCIWNDM_开头的自定义消息MCIWndSM(hwnd, msg, wParam, lParam)是这条通道的通用入口。当某个封装好的宏满足不了需求时用MCIWndSM直接发消息是可行的补救方式但优先级应该排在「换个方案」之后。2.3 选型边界能放什么、不能放什么能放什么取决于机器上注册了哪些 VfW 解码器。未压缩 AVI、MS Video 1、Cinepak、Indeo 这类老编码在干净系统上基本都还在是最稳的组合。装了对应解码器的 DivX、Xvid 也能放。不能放的情况更值得记H.264、HEVC 封在 AVI 里绝大多数机器上会打开失败或只有声音多音轨、内嵌字幕、精确到帧的定位这套接口先天不支持。如果你的需求里有这几项别在 MCIWnd 上耗时间Media Foundation 或别的解码方案才是对的起点。还有一个容易被忽略的边界MCIWnd 默认会自己调整窗口大小去适配视频尺寸这个行为在嵌入到固定布局里时非常烦人需要用MCIWNDF_NOAUTOSIZEWINDOW关掉第六节会展开。3. 从空工程到能播MCIWnd 播放器骨架3.1 工程配置与窗口类注册新建一个空的 Win32 桌面工程删掉模板生成的代码只保留入口。字符集建议先设成「使用多字节字符集」——这不是审美问题MCIWndGetError的输出缓冲是charMCI 内部拼的 open 命令也是 ANSI在 Unicode 工程里这几处要额外转换第一版先绕开能省不少时间。等骨架跑通了再决定要不要改回 Unicode 并补转换。// 注册宿主窗口类之前先把 MCIWnd 的窗口类注册掉 int APIENTRY WinMain(HINSTANCE hInst, HINSTANCE, LPSTR lpCmdLine, int) { g_hInst hInst; // 少了这一句MCIWndCreate 会返回 NULL且不给你任何错误提示 MCIWndRegisterClass(); WNDCLASSA wc {0}; wc.lpfnWndProc WndProc; wc.hInstance hInst; wc.hCursor LoadCursor(NULL, IDC_ARROW); wc.lpszClassName PlayerHost; RegisterClassA(wc); HWND hWnd CreateWindowExA(0, PlayerHost, AVI Player, WS_OVERLAPPEDWINDOW | WS_VISIBLE, CW_USEDEFAULT, CW_USEDEFAULT, 800, 600, NULL, NULL, hInst, NULL); // 命令行参数直接当文件路径用方便反复调试同一个文件 if (lpCmdLine *lpCmdLine) OpenAndPlay(hWnd, lpCmdLine); MSG msg; while (GetMessage(msg, NULL, 0, 0)) { TranslateMessage(msg); DispatchMessage(msg); } return (int)msg.wParam; }MCIWndRegisterClass是整段代码里最容易漏、报错信息最少的一步。漏掉之后MCIWndCreate只是安静地返回 NULL既不设GetLastError也没有弹窗排查起来毫无线索。我现在的习惯是把它写在WinMain第一行跟InitCommonControls一个位置形成肌肉记忆。WS_OVERLAPPEDWINDOW | WS_VISIBLE是宿主窗口的基本样式宽高先给 800×600 只是为了看得清真正决定播放器尺寸的是后面的WM_SIZE处理。命令行参数接文件这个做法看着简陋但在调 seek 精度、调时间格式的时候能省掉每次点「打开文件」的重复劳动。3.2 创建播放器并打开 AVI 文件播放器窗口在WM_CREATE里创建样式位决定了它有多少自带 UI。MCIWNDF_NOPLAYBAR去掉默认那排按钮MCIWNDF_NOTIFYPOS和MCIWNDF_NOTIFYMODE打开位置与状态通知MCIWNDF_NOTIFYERROR让错误走消息而不是弹系统框。case WM_CREATE: DragAcceptFiles(hWnd, TRUE); // 允许把 avi 直接拖进窗口 g_hPlayer MCIWndCreate(hWnd, g_hInst, WS_CHILD | WS_VISIBLE | WS_CLIPCHILDREN | MCIWNDF_NOPLAYBAR | // 不要默认控制条自己画 MCIWNDF_NOTIFYPOS | // 位置变化 - 通知父窗口 MCIWNDF_NOTIFYMODE | // 播放/暂停状态变化 - 通知 MCIWNDF_NOTIFYERROR, // 出错走通知不弹系统对话框 NULL); // 文件留到后面再打开 if (!g_hPlayer) MessageBoxA(hWnd, MCIWnd 创建失败检查是否漏了 MCIWndRegisterClass, 错误, MB_ICONERROR); break;打开文件单独封装成一个函数因为「关闭上一个、打开新的、设置时间格式、开始播放」这四步在每个入口都要走一遍散在消息处理里很容易漏。static void OpenAndPlay(HWND hWnd, const char* path) { if (!g_hPlayer || !path || !*path) return; // 1) 先关掉上一个文件否则 MCI 设备一直被占着新文件打不开 MCIWndClose(g_hPlayer); // 2) 打开注意返回 0 才是成功 if (MCIWndOpen(g_hPlayer, path, 0) ! 0) { char err[256] {0}; MCIWndGetError(g_hPlayer, err, sizeof(err)); MessageBoxA(hWnd, err[0] ? err : MCI 未返回错误文本, 打开失败, MB_ICONERROR); return; } // 3) 明确指定时间格式 p a hrefhttps://download.csdn.net/download/kathychou/1317362 stylecolor:#ec7500;font-size:14px; 本文还有配套的精品资源点击获取 /a img altmenu-r.4af5f7ec.gif srchttps://csdnimg.cn/release/wenkucmsfe/public/img/menu-r.4af5f7ec.gif stylewidth:16px;margin-left:4px;vertical-align:text-bottom;cursor:text; /p