简介基于MFC的OCX控件开发教程与示例源代码面向需要在Windows桌面应用中集成ActiveX控件或通过Web页面调用OCX能力的开发者。整套内容以海康摄像头控制为实际案例系统讲解从MFC ActiveX工程创建、CWnd控件类继承、DISPID接口设计、属性与事件实现到控件注册及与硬件SDK交互的完整流程并包含Web端嵌入与调用OCX的思路适合有一定C基础、正在做设备控制或浏览器混合方案的工程人员。压缩包共88个文件约68.7MB其中主要类型包括21个dll运行库、8个h头文件、5个cpp源码、4个lib库文件、2个ocx控件文件另有PDF教程、HTML说明、工程配置文件及编译过程生成文件目录层级清晰便于按模块阅读和二次编译。目前已有487人学习下载资料既提供文档讲解也给出可运行的MFC工程与海康SDK接入示例对掌握OCX开发要点、解决云台控制和Web调用问题有实际帮助。1. 为什么还要写 MFC 的 OCX 控件网页调用云台控制绕不过这条老路基于 MFC 的 OCX 控件开发教程及示例源代码这标题放到今天多少有点“老古董”味道。可我在做模拟项目 X 的时候偏偏就是它救了我一台内网里的网络摄像机网页要实时预览、要按着按钮转云台浏览器却只认 ActiveX。翻遍现代 Web 技术没有比 OCX 更直接的通道。这套教程配合源码适合正在对接老系统、需要把某个厂商 SDK 封装成控件再丢给网页调用的工程师。如果你还没被 ActiveX 的注册和安全设置虐过正好拿它试试水。2. MFC ActiveX 控件开发前夜OCX 这个黑匣子怎么和网页对话2.1 OCX 的实质一个跑在客户端的 COM 组件从浏览器角度想这个问题摄像头 SDK 是本地 DLL网页 JavaScript 没有权限直接加载它。想做到网页点按钮云台就转必须有一个能被浏览器识别并加载的本地模块这个模块就是 ActiveX 控件后缀常见为 .ocx。ActiveX 是建立在 COM 之上的一套接口规范只要实现了 IUnknown、IDispatch、IOleObject 等关键接口浏览器就能把它当作一个“插件”实例化。MFC 的厉害之处在于 COleControl 已经把这些接口全部包好了。开发者只需要在派生类里写自己的业务方法不用自己手写 COM 接口表也不用管引用计数怎么维护。网页调用 ocx1.Open() 时COM 运行库先通过注册表里的 CLSID 找到控件 DLL然后定位到 IDispatch::Invoke最终进入 MFC 的分发映射由映射找到 Open 对应的 C 成员函数。整个过程对网页是透明的你只要在 classid 里写对一串 GUID。理解这个链路后你会发现 OCX 的所有麻烦都集中在客户端环境杀毒软件可能拦截、浏览器安全级别可能禁掉、32 位与 64 位可能不匹配。后面讲避坑时会挨个说。2.2 为什么是 MFC 而不是 ATL向导生成的差距很多人在选择开发 ActiveX 方案时会在 MFC 和 ATL 之间纠结。我直接说结论封装厂商摄像头 SDK选 MFC 能省一半时间。表格整理一下两者差异对比项MFC ActiveXATL ActiveX框架代码量向导生成几十个文件包含窗口、属性页、类型库生成精简 COM 代码但事件源、连接点要手动补Web 脚本调用分发映射和事件映射开箱即用需要手写 IDL 和连接点接口改动容易遗漏部署依赖可能依赖 MFC 运行时建议静态链接依赖少但功能层要自己搭适用场景快速封装 SDK、需要属性页、需要事件回调追求体积小、系统级 COM 组件我在另一个项目里用 ATL 写过独立 COM 组件确实体积小。但每当要加一个方法都要检查接口声明、实现类、IDL 三处是否一致漏一处编译就过不去。MFC 类向导添加方法时会同步更新分发映射、ODL 和头文件几乎不会出现“方法没暴露给脚本”的情况。代价是 MFC 控件默认依赖 MFC 运行库发布机器如果没装 VC 运行库控件注册后一加载就崩。解决方案是用静态链接 MFC后面部署章节会具体说。2.3 把接口先定明白方法要返回值事件要提前设计在写代码前先把控件对外接口定下来。以这个 OCX 控件为例最小接口集合足够覆盖常见场景属性DeviceIP、Port、UserName、Password、Channel方法Open()、Close()、StartPreview()、StopPreview()、PTZControl(cmd, stop)事件OnLogined(BSTR ip)、OnDisconnected(BSTR reason)先说方法返回值。厂商 SDK 的登录接口返回的是登录句柄错误码也是 long所以 Open() 返回 long 比返回 BOOL 实用得多。网页 JS 能拿到错误码就能自己判断是登录失败还是网络超时。再看 IDL 片段理解 id 怎么对应 JS[ uuid(1A2B3C4D-....-....-....-............), helpstring(CameraOCX Control), control ] coclass CameraOCX { [default] interface _DCameraOCX; [default, source] dispinterface _DCameraOCXEvents; }; library CameraOCXLib { dispinterface _DCameraOCX { properties: [id(1)] BSTR DeviceIP; [id(2)] short Port; methods: [id(3)] long Open(); [id(4)] void PTZControl(short nCmd, short nStop); }; }这里 id(1) 对应网页 JS 里的 ocx1.DeviceIPid(3) 对应 ocx1.Open()。重要的是参数类型只能使用自动化兼容类型BSTR、short、long、VARIANT_BOOL。如果你自定义一个结构体作为方法参数网页脚本根本没法传值这是新手最常见的“为什么 JS 调不了”的原因。事件这块容易被忽略。网页想等设备断线通知不能靠轮询最好由 OCX 主动触发事件。在 IDL 里用 source dispinterface 声明事件MFC 类向导会生成 FireEvent 调用。接口设计阶段就把事件想好后面就不用返工。2.4 安全标记为什么控件在别的机器上经常被拦ActiveX 控件默认会被浏览器当成不安全的插件。用户在受信任站点之外打开页面会看到“此 ActiveX 控件可能不安全”之类的提示甚至直接显示灰色 X。要减少这种干扰有两个方向。第一个方向是让控件实现 IObjectSafety 接口声明自己“可安全执行脚本”和“可安全初始化”。MFC 向导不会自动生成这层代码常见做法是写一个辅助类实现 IObjectSafety再重写控件的 QueryInterface 暴露它。这个方案适合你要把控件放到公网或大量非受信任站点时使用。第二个方向更粗暴也更常见在内网系统的部署中直接把页面站点加入受信任区域在组策略里允许运行未签名 ActiveX。这个做法省代码但安全边界会变小。我一般建议开发阶段用第二种发布前再补 IObjectSafety 标记。否则你会在不同客户机器上反复被安全拦截折磨而且问题时有时无非常玄学。注意即使浏览器弹出“是否允许运行 ActiveX 控件”点击允许后 JS 访问控件方法仍可能失败。这类现象多半不是安全策略问题而是控件本身加载失败或 32/64 位不匹配。3. 完整开发步骤从建工程到云台能转起来3.1 建工程VS 向导生成的东西已经能注册用 Visual Studio 新建项目时选择 MFC ActiveX Control。给项目命名比如 CameraOCX。向导会生成 CCameraOCXCtrl、CCameraOCXPropPage 等类。编译一次项目属性里默认会执行注册你甚至不需要手动 regsvr32 就能在开发机用。生成的控件类里有一段分发映射这是 JS 调用入口的关键BEGIN_DISPATCH_MAP(CCameraOCXCtrl, COleControl) DISP_PROPERTY_NOTIFY_ID(CCameraOCXCtrl, DeviceIP, dispidDeviceIP, m_strIP, OnIPChanged, VT_BSTR) DISP_FUNCTION_ID(CCameraOCXCtrl, Open, dispidOpen, Open, VT_I4, VTS_NONE) DISP_FUNCTION_ID(CCameraOCXCtrl, PTZControl, dispidPTZ, PTZControl, VT_EMPTY, VTS_I2 VTS_I2) END_DISPATCH_MAP()DISP_FUNCTION_ID 最后两个参数分别是返回值类型和参数类型。VT_I4 是 longVTS_I2 是 short。用类向导添加方法时默认可能生成 short如果 SDK 接口需要 int记得手动调整成 VTS_I4否则参数范围不够。DISP_PROPERTY_NOTIFY_ID 里的 OnIPChanged 是属性变化通知适合在网页修改 IP 后重新断开设备。生成控件后classid 从工程的 .rgs 文件或 .tlb 里找。复制那一长串 GUID后面写 HTML 的3.2 接入 SDKOpen 方法不要只写“返回 0”网络摄像机厂商提供的大多是 C 接口的 SDK DLL。OCX 里的 Open 方法要完成网络初始化、设备登录、句柄保存这几件事。如果只是随便 return 0后面云台控制绝对会失败因为登录句柄根本没拿到。下面是一个简化后的实现保留关键流程long CCameraOCXCtrl::Open() { if (m_lLoginHandle 0) return m_lLoginHandle; NET_DVR_Init(); // 某些厂商SDK需要先初始化 NET_DVR_USER_LOGIN_INFO loginInfo {0}; // m_strIP 来自 OCX 属性网页赋值后可直接使用 sprintf_s(loginInfo.sDeviceAddress, %s, (LPCSTR)m_strIP); loginInfo.wPort (WORD)m_nPort; sprintf_s(loginInfo.sUserName, %s, (LPCSTR)m_strUser); sprintf_s(loginInfo.sPassword, %s, (LPCSTR)m_strPassword); NET_DVR_DEVICEINFO_V40 devInfo {0}; m_lLoginHandle NET_DVR_Login_V40(loginInfo, devInfo); if (m_lLoginHandle 0) { m_lErrorCode NET_DVR_GetLastError(); return m_lErrorCode; } return m_lLoginHandle; }这个方法里最容易被忽略的是重复登录。如果网页不小心调两次 Open登录句柄会被覆盖但旧句柄没退出最终 SDK 内部资源耗尽。所以第一行做了判断已有句柄直接返回。m_nChannel 也建议作为属性暴露出来因为 SDK 的云台控制接口通常需要通道号。如果你的设备是单通道可以写死 1但多通道设备不传对就不会控制。登录失败时把 NET_DVR_GetLastError 的返回值存到控件成员变量里再在 JS 中通过另一个属性读取这样调试不用看 VC 输出窗口。我当时在模拟项目里就靠这个办法快速定位了几个客户现场的密码错误问题。3.3 云台控制方法停止命令是纪律云台控制是网页交互的重点。厂商 SDK 一般会提供类似 NET_DVR_PTZControl 的函数参数包含登录句柄、通道号、云台动作、是否停止。MFC 控件方法封装如下void CCameraOCXCtrl::PTZControl(short nCommand, short nStop) { if (m_lLoginHandle 0) return; // nCommand: 云台动作编码来自厂商SDK头文件 // nStop: 0 表示开始动作1 表示停止动作 NET_DVR_PTZControl(m_lLoginHandle, m_nChannel, nCommand, nStop); }这个方法本身不复杂复杂的是网页端的交互纪律。云台控制按钮要求“按下持续转动松开停止”所以 JS 必须在 onmousedown 发送 nStop0在 onmouseup 发送 nStop1。如果只发开始命令忘了停止云台会一直转到机械限位轻则电机堵转重则损坏设备。我在之前一个项目里吃过这个亏当时只处理了 onmouseup没处理 onmouseout。用户按住按钮后鼠标滑出按钮onmouseup 就不会触发云台就停不下来。从那以后我要求云台相关按钮必须同时绑定 onmouseout 兜底。更保险的做法是在 OCX 内部加一个定时器比如每 5 秒如果没有收到新的开始命令就自动发一次停止命令。这个兜底策略虽然粗暴但能在网页崩溃时避免设备一直转。3.4 注册与部署不要只带一个 ocx 文件发布时开发机器上注册没问题不代表目标机器能用。最简单的注册命令是regsvr32 /s CameraOCX.ocx/s 表示静默执行。卸载用 /u。如果你在 64 位系统上注册 32 位 OCX系统默认会调用 64 位 regsvr32导致报错“模块已加载但没有找到 DllRegisterServer 入口点”。这时需要手动运行 32 位版本的 regsvr32路径在 C:\Windows\SysWOW64\regsvr32.exe。只拷贝一个 ocx 文件是不够的。厂商 SDK 往往自带几个 DLL 和依赖运行库比如 hcNetSDK.dll 之类的组件。我建议工程属性里把 MFC 使用方式改成“在静态库中使用 MFC”这样目标机器不用额外装 VC 运行库。SDK 的 DLL 和安全模块还是得放在 ocx 同目录并在注册命令前先放到 C:\Windows\System32 或控件目录。给网页自动安装时可以用 CAB 打包。首先建一个 .inf 文件[version] signature$CHICAGO$ AdvancedINF2.0 [Add.Code] CameraOCX.ocxCameraOCX.ocx [CameraOCX.ocx] file-win32-x86thiscab clsid{1A2B3C4D-....-....-....-............} RegisterServeryes再用 makecab 命令或者 INF 工具打包。网页 object 标签的 codebase 指向 cab 文件浏览器下载后会自动解压注册。这里最大的坑是没有签名的 CAB 在 IE 增强安全配置下基本都会被拦。企业内网环境一般可以通过组策略放行但外网客户机就只能去签代码签名证书。如果只是为了内网自用直接做一个批量安装脚本比研究 CAB 签名快得多。3.5 网页端调用按钮按住云台动起来HTML 页面里的 object 标签classid 必须是控制件真实的 CLSID。示例object idocx1 classidclsid:1A2B3C4D-....-....-....-............ width640 height480 /object如果控件带窗口并预览画面object 的宽高决定预览区域大小。网页加载后先用 JS 设置属性再调用 Openocx1.DeviceIP 192.168.1.64; ocx1.Port 8000; ocx1.UserName admin; ocx1.Password 123456; var ret ocx1.Open(); if (ret 0) { alert(登录失败错误码 ret); }云台按钮和鼠标事件function startPTZ(cmd) { if (ocx1.Open() 0) ocx1.PTZControl(cmd, 0); } function stopPTZ(cmd) { ocx1.PTZControl(cmd, 1); } document.getElementById(btnUp).onmousedown function() { startPTZ(38); }; document.getElementById(btnUp).onmouseup function() { stopPTZ(38); }; document.getElementById(btnUp).onmouseout function() { stopPTZ(38); };这里 38 只是示例动作编码不同 SDK 定义不同要打开头文件确认。onmouseout 里的 stop 非常重要因为鼠标可能从按下状态直接移出按钮此时 onmouseup 不触发云台就会一直转。调用前判断 Open 返回值避免还没登录就发云台命令。4. 避坑清单OCX 从开发到部署这五个坑我全替你蹚过4.1 注册报错“没有找到 DllRegisterServer 入口点”现象regsvr32 执行后提示模块已加载但找不到入口点控件注册失败。原因系统用 64 位 regsvr32 注册了 32 位 OCX或者 OCX 依赖的 DLL 缺失导致导出函数无法访问。解决先确认控件是 32 位还是 64 位再选择对应位数的 regsvr32。64 位系统注册 32 位组件用 C:\Windows\SysWOW64\regsvr32.exe。再把厂商 SDK 的 DLL 都放到 ocx 同目录或 System32 下。如果还报错用依赖检查工具看缺失文件。4.2 页面加载控件后白屏JS 报“Automation 服务器不能创建对象”现象网页上控件区域空白或红色叉JScript 调用 ocx1.Open() 会弹脚本错误。原因classid 写错、控件没注册成功、浏览器安全级别禁用 ActiveX、页面脚本在控件完全加载前执行。解决用 regsvr32 重新注册确认注册表里 classid 有一致的 InprocServer32 键值。将页面站点加入受信任区域并启用“对未标记为可安全执行脚本的 ActiveX 控件初始化并执行脚本”。在 JS 里把操作放到 window.onload 或 setTimeout 延迟执行给控件加载留时间。4.3 云台一直转松开鼠标还不停现象按住“上”键云台向上松开后仍继续转只有再按一次其他方向才停。原因只发了开始命令没有发停止命令onmouseup 没有触发或 OCX 内部没把 stop 参数透传到 SDK。解决所有云台按钮统一绑定 onmouseup 和 onmouseout 都发 stop。OCX 方法里检查 nStop 是否为 1确保 SDK 的停止接口被调用。我在代码里增加了定时器兜底超过 5 秒没有新命令就自动发一次停止防止网页崩溃或用户切窗口导致鼠标事件丢失。4.4 页面刷新后 IE 进程崩溃或内存暴涨现象开发调试时刷新页面第一次正常第二次之后 IE 卡死任务管理器里内存持续增长。原因OCX 的 OnDestroy 没有关闭设备登录句柄SDK 内部线程没有退出控件销毁时设备回调还在触发访问了已释放的内部成员。解决在控件的 OnDestroy 里调用 Close() 和 SDK 清理接口比如 NET_DVR_Cleanup()。网页端在 onbeforeunload 里也主动调一次 ocx1.Close()双保险。如果用了静态回调函数回调里不能直接调用非静态成员必须通过 map 找到控件实例后再调 FireEvent否则也会崩溃。4.5 预览画面只显示一半或者对象被页面遮挡现象OCX 预览画面被网站的 div 遮挡点击按钮没反应或画面只渲染局部区域。原因ActiveX 控件在浏览器里是以窗口方式嵌入的默认 z-index 低于普通 HTML 元素如果父容器用了 overflow 滚动控件可能无法正确响应鼠标消息。解决将 OCX 放在独立 div 中不要设置 float 或苛刻的 overflow。iframe 包裹控件也可以但注意 JS 跨域问题。云台按钮不要覆盖在 OCX 上方避免页面元素抢占鼠标事件。如果必须覆盖建议把按钮放到 OCX 旁边而不是用绝对定位压上去。5. 进阶用事件把设备断开推给网页并搭一套固定验证流程5.1 事件映射怎么发到网页MFC ActiveX 控件自带事件机制添加事件后类向导会生成类似这样的映射BEGIN_EVENT_MAP(CCameraOCXCtrl, COleControl) EVENT_CUSTOM_ID(OnDisconnected, dispidDisconnected, OnDisconnected, VTS_BSTR) END_EVENT_MAP()在 SDK 的断线回调或登录失败分支里调用 FireEventvoid CCameraOCXCtrl::NotifyDisconnected(CString strReason) { FireOnDisconnected(strReason); }网页端用 FOR 属性绑定事件注意这是 IE 特有写法script forocx1 eventOnDisconnected(reason) languageJScript alert(设备断开 reason); /script这一步能让网页在设备掉线时主动弹出提示而不是用户盯着画面卡死了还不知道。事件回调参数类型也必须和 IDL 里一致都声明成 BSTRJS 拿到的 reason 才是字符串。如果回调里传 char*网页端会出现乱码这也是新手常踩的坑。5.2 我的固定验证流程每次改完代码我都会强制走一遍完整流程编译 Release 版 → 手动 regsvr32 注册 → 打开 OLE/COM Object Viewer 或注册表确认 classid → 用 IE 内核浏览器打开测试页面 → 在网页里设置属性 → 调 Open 看错误码 → 分别测试登录失败、正常登录、云台开始、云台停止 → 连续刷新页面五次看进程是否稳定 → 最后拔掉网线测一次断线回调。这套流程看起来啰嗦但能拦住九成部署事故。尤其“连续刷新五次”这一步很多 demo 第一次加载没问题刷新两次就崩溃原因就是资源释放没做好。从那以后我每次发布 OCX 都强制走一遍这套验证客户现场翻车率明显降下来了。希望帮到你。本文还有配套的精品资源点击获取