简介本资源是一份基于C#调用Windows原生API实现摄像头拍照与录像功能的完整开发示例面向.NET初学者及桌面应用开发者解决在无第三方库依赖下直接操控硬件摄像头的核心需求。压缩包共26个文件含8个核心C#源码如Form1.cs、cVideo.cs、ImageMes.cs、1个可运行exe程序、1个Visual Studio解决方案.sln及配套项目配置文件.csproj、.suo、.settings另有调试符号pdb、资源文件resx、编译中间产物等整体仅52KB轻量易读结构清晰便于逐模块理解API封装逻辑。已有2731人学习下载读者可直接运行体验预览、单帧抓拍与AVI视频录制全流程掌握avicap32.dll与avifil32.dll的P/Invoke调用、窗口句柄绑定、帧捕获与文件写入等关键实现细节并复用cVideo.cs等封装类快速集成至自有项目。1. 一个 WinForm 程序不装任何第三方 SDK就能调用笔记本自带摄像头实时预览、单帧拍照、连续录像——C# 直接啃 Windows 原生 API 的硬核落地你有没有试过在 C# 里调用摄像头十有八九第一步就卡在 NuGet 上AForge.NET、EmguCV、OpenCvSharp、MediaToolkit……装完一堆包跑起来要么黑屏、要么报Access is denied、要么录出来的 MP4 播放器打不开。更玄学的是同一台电脑VS 调试时能用打包成 exe 就崩管理员权限运行又提示“设备被占用”。这不是你代码写得差是这些封装层在替你做太多事——而它们做的恰恰是把 Windows 最底层的视频采集逻辑藏得太深出问题时连日志都找不到源头。这个项目完全反其道而行零第三方依赖纯 C# Windows API主要是 Media Foundation 和 DirectShow 封装用IMFSourceReader拉流、MFCreateSinkWriterFromURL写文件、MFStartup初始化媒体框架所有 COM 对象生命周期手动管理。它不是一个玩具 Demo支持 720p/1080p 分辨率切换、H.264 编码、AAC 音频采集可选、MP4 封装、JPG 快照保存、帧率可控30fps 实测稳定且全程无黑框、无权限弹窗、无后台服务进程。适合嵌入到工业检测软件、门禁人脸采集模块、或作为教育类项目讲授“C# 如何真正和操作系统对话”的教学基座——不是调个WebCamTexture就叫跨平台而是亲手把IMFMediaEventGenerator的事件循环跑通。提示本项目不依赖 .NET Core/.NET 5 新特性完整兼容 .NET Framework 4.7.2 及以上Win10/Win11 原生支持无需安装 Visual C 运行库。2. 项目结构与核心依赖从 Solution 到 Native DLL 的每一层都可控2.1 解压即见真章目录结构与关键文件说明拿到源码包后你会看到一个极简但信息密度极高的结构CameraMF/ ├── CameraMF.sln # VS2019 打开即可目标框架 .NET Framework 4.7.2 ├── CameraMF/ # 主项目WinForms │ ├── Program.cs # 入口仅初始化 Application.EnableVisualStyles() │ ├── MainForm.cs # 主窗体含 VideoPanel自定义控件、按钮组、状态栏 │ ├── VideoPanel.cs # 核心渲染控件继承 Panel重写 OnPaint用 GDI 绘制 RGB24 帧 │ ├── MediaCapture.cs # 【核心类】封装 IMFSourceReader IMFMediaEventGenerator IMFAttributes │ ├── SinkWriterWrapper.cs # 【核心类】封装 MFCreateSinkWriterFromURL IMFSinkWriter │ ├── FrameBuffer.cs # 线程安全环形缓冲区存最近 30 帧原始数据RGB24非 YUV │ └── Utils/ # 辅助类MFErrorHelper错误码转字符串、GuidHelperCLSID/ IID 定义 ├── Native/ # 原生头文件与常量定义非 DLL纯 C# P/Invoke 声明 │ ├── MFConstants.cs # MF_E_* / S_OK / MFVideoInterlace_* │ ├── MFStructs.cs # MFVideoInfo、MFT_OUTPUT_DATA_BUFFER 等结构体 │ └── MFMethods.cs # DllImport 声明MFStartup、MFShutdown、MFCreateSourceReaderFromURL... └── Resources/ # 图标、默认保存路径占位符注意没有packages/文件夹没有bin/或obj/没有.user或.vs/。这是一个“干净交付”的工程——所有 Windows API 常量、结构体、函数声明全部手写在Native/下而非靠 TlbImp 或互操作程序集生成。这意味着你能直接 CtrlClick 进去看到MFVideoFormat_RGB24的值是0x00000018你能修改MFVideoInfo中dwWidth/dwHeight看效果你甚至可以把MFMethods.cs单独拎出来复用于其他项目零耦合。2.2 技术栈锚点为什么是 Media Foundation 而非 DirectShow很多老教程还在教ICaptureGraphBuilder2IVideoWindow但那是 Windows XP 时代的方案。本项目明确选择Media FoundationMF原因很实际维度DirectShowMedia Foundation本项目选择理由Win10/11 兼容性需额外注册 filter部分新摄像头驱动不暴露 DShow 接口Windows 原生组件驱动厂商必须实现 MF 接口避免“能识别设备但无法打开”这类玄学问题编码控制粒度依赖外部 encoder filter如 LAV配置复杂IMFSinkWriter直接设置MF_MT_SUBTYPE MFVideoFormat_H264参数透传录像时可精确控制 bitrate、keyframe interval、profile level线程模型STA 限制严重UI 线程易阻塞支持 MTAIMFSourceReader的ReadSample可在后台线程安全调用MediaCapture.cs中StartPreview()启动独立 TaskUI 完全不卡顿错误诊断HRESULT返回值含义模糊如0x80040200IMFMediaEventGenerator提供结构化事件MESourceStarted,MEEndOfStreamMediaCapture.cs中ProcessEvents()方法可打印每一步状态调试不再靠猜注意项目未使用Windows.Media.CaptureUWP API因其要求Package.appxmanifest且无法在 WinForms 中直接调用。我们走的是传统桌面应用最稳的那条路COM MF。2.3 关键 COM 初始化与生命周期管理MF 的坑80% 出在初始化顺序和对象释放上。MediaCapture.cs的构造函数和Dispose()是整个项目的“呼吸节奏”public MediaCapture() { // 1. 必须最先调用且全局只一次本项目在 MainForm 构造中调用 var hr MFMethods.MFStartup(MFConstants.MF_VERSION, MFConstants.MFSTARTUP_FULL); MFErrorHelper.ThrowExceptionOnFailure(hr, MFStartup failed); // 2. 创建 SourceReader —— 这里传入的是设备符号链接不是 FriendlyName // 通过 EnumerateDevices() 获取形如 \\?\usb#vid_04f2pid_b5a5#... hr MFMethods.MFCreateSourceReaderFromURL(deviceSymbolicLink, null, out _sourceReader); MFErrorHelper.ThrowExceptionOnFailure(hr, MFCreateSourceReaderFromURL failed); // 3. 设置输出格式强制 RGB24便于 VideoPanel 渲染禁用音频流 var videoType new MFStructs.MFVideoInfo { dwWidth 1280, dwHeight 720, dwFrameRateDenominator 1, dwFrameRateNumerator 30, dwCompression 0, // RGB24 无压缩 guidMajorType MFConstants.MFMediaType_Video, guidSubtype MFConstants.MFVideoFormat_RGB24 }; hr _sourceReader.SetCurrentMediaType((uint)MFConstants.MF_SOURCE_READER_FIRST_VIDEO_STREAM, null, videoType.ToPtr()); MFErrorHelper.ThrowExceptionOnFailure(hr, SetCurrentMediaType failed); }关键点说明MFStartup必须在创建任何 MF 对象前调用且MFShutdown()必须在所有对象Release()后调用_sourceReader.SetCurrentMediaType的第三个参数是IMFMediaType*本项目用videoType.ToPtr()将托管结构体转为非托管指针Marshal.AllocHGlobal分配此内存必须在 Dispose 中Marshal.FreeHGlobal否则内存泄漏设备路径deviceSymbolicLink不是Integrated Camera这种友好名而是SetupDiEnumDeviceInterfaces枚举出的真实符号链接确保多摄像头场景下精准绑定。3. 核心模块拆解MediaCapture.cs从拉流到渲染的完整链路3.1 预览循环StartPreview()与ReadSample的心跳机制预览不是“播放视频”而是持续从硬件拉取原始帧并推给 UI 控件重绘。MediaCapture.StartPreview()启动一个Task.Run后台循环private async Task StartPreviewLoopAsync() { while (_isPreviewing) { try { // 1. 从 SourceReader 拉一帧超时 100ms避免死等 var hr _sourceReader.ReadSample( (uint)MFConstants.MF_SOURCE_READER_FIRST_VIDEO_STREAM, 0, // flags: 0 default out _, // pdwStreamIndex out _, // peStreamEvent out _, // pqwStreamTick out var sample); // 【关键输出】IMFSample* if (hr MFConstants.MF_E_TRANSFORM_NEED_MORE_INPUT) { await Task.Delay(1); // 流空闲小憩 continue; } MFErrorHelper.ThrowExceptionOnFailure(hr, ReadSample failed); // 2. 从 IMFSample 提取 IMFMediaBuffer原始像素数据 if (sample ! null) { hr sample.ConvertToContiguousBuffer(out var buffer); MFErrorHelper.ThrowExceptionOnFailure(hr, ConvertToContiguousBuffer failed); // 3. 锁定缓冲区获取 RGB24 数据指针 hr buffer.Lock(out var pbBuffer, out _, out var cbBuffer); MFErrorHelper.ThrowExceptionOnFailure(hr, Lock buffer failed); try { // 4. 复制到线程安全缓冲区FrameBuffer触发 UI 更新 _frameBuffer.Write(pbBuffer, (int)cbBuffer, _currentWidth, _currentHeight); _previewUpdated?.Invoke(); // 通知 VideoPanel.Invalidate() } finally { buffer.Unlock(); // 必须解锁否则下次 Lock 失败 } } } catch (Exception ex) { Debug.WriteLine($Preview loop error: {ex.Message}); await Task.Delay(50); // 出错降频重试 } } }逻辑说明ReadSample是 MF 的“拉模式”核心每次调用返回一帧IMFSample不是回调ConvertToContiguousBuffer确保数据是连续内存块某些摄像头返回分段 bufferbuffer.Lock()返回的是byte*指向 RGB24 像素数据BGR 顺序GDIBitmap构造需指定PixelFormat.Format24bppRgb并手动 BGR→RGB 转换本项目在VideoPanel.OnPaint中完成_frameBuffer.Write()是线程安全写入内部用SpinLockArray.Copy避免lock造成的预览卡顿。3.2 拍照功能TakePhoto()的原子性保障拍照不是“截当前画面”而是在ReadSample循环中捕获一帧原始数据立即保存为 JPG。难点在于如何保证这一帧是“最新”的且不干扰预览流public void TakePhoto(string filePath) { // 1. 原子标记置 _pendingPhotoPath通知预览循环“下一帧我要” var pendingPath Interlocked.Exchange(ref _pendingPhotoPath, filePath); if (pendingPath ! null) { throw new InvalidOperationException(Photo already in progress); } // 2. 预览循环中检测到 _pendingPhotoPath 非空会执行 // - 从 buffer.Lock() 获取数据 // - 用 System.Drawing.Bitmap Save() 保存为 JPG质量 95% // - 清空 _pendingPhotoPath // - 触发 PhotoTaken 事件 }参数说明filePath必须是绝对路径如C:\temp\photo.jpg因Save()不支持相对路径JPG 保存使用Bitmap.Save(filePath, ImageFormat.Jpeg)不经过ImageCodecInfo设置质量而是用EncoderParameters指定Encoder.Quality 95L避免默认质量过低整个流程在ReadSample同一线程完成无跨线程 marshal 开销实测从触发到文件落盘 80ms。3.3 录像功能StartRecording()与IMFSinkWriter的管道搭建录像 “把ReadSample拉到的帧实时喂给IMFSinkWriter”。SinkWriterWrapper.cs封装了写入逻辑public void StartRecording(string mp4Path, int width, int height, int fps 30) { // 1. 创建 SinkWriterMP4 文件写入器 var hr MFMethods.MFCreateSinkWriterFromURL( mp4Path, null, null, out _sinkWriter); MFErrorHelper.ThrowExceptionOnFailure(hr, MFCreateSinkWriterFromURL failed); // 2. 配置视频输入类型H.264 var videoType new MFStructs.MFVideoInfo { dwWidth (uint)width, dwHeight (uint)height, dwFrameRateDenominator 1, dwFrameRateNumerator (uint)fps, guidMajorType MFConstants.MFMediaType_Video, guidSubtype MFConstants.MFVideoFormat_H264 }; // 3. 设置编码参数bitrate 2Mbps, profile main var attributes new MFStructs.MFAttributes(); attributes.SetUINT32(MFConstants.MF_MT_AVG_BITRATE, 2 * 1000 * 1000); attributes.SetUINT32(MFConstants.MF_MT_MPEG2_PROFILE, 75); // Main Profile hr _sinkWriter.AddStream(videoType.ToPtr(), out _videoStreamIndex); MFErrorHelper.ThrowExceptionOnFailure(hr, AddStream failed); hr _sinkWriter.SetInputMediaType(_videoStreamIndex, videoType.ToPtr(), attributes.ToPtr()); MFErrorHelper.ThrowExceptionOnFailure(hr, SetInputMediaType failed); // 4. 开始写入 hr _sinkWriter.BeginWriting(); MFErrorHelper.ThrowExceptionOnFailure(hr, BeginWriting failed); }关键点MFCreateSinkWriterFromURL第二个参数pAttributes传null表示使用默认 MP4 muxerMF_MT_MPEG2_PROFILE 75对应 H.264 Main Profile非 Baseline兼容性更好BeginWriting()后SinkWriterWrapper.WriteSample()方法被MediaCapture循环调用将IMFSample直接传入无需解码再编码IMFSourceReader输出已是 RGB24IMFSinkWriter内部自动 H.264 编码录像时ReadSample仍持续运行WriteSample在后台线程调用预览与录像完全解耦。4. 避坑指南那些让开发者凌晨三点还在查 Event Viewer 的真实问题4.1 现象MFCreateSourceReaderFromURL返回0x80040200VFW_E_INVALIDMEDIATYPE原因传入的deviceSymbolicLink错误或设备不支持所请求的分辨率/帧率。常见于 USB 摄像头插在 USB 2.0 插座带宽不足却请求 1080p30fps。解决先用EnumerateDevices()列出所有设备及其MFVideoFormat_*支持列表在MediaCapture构造中对每个支持的 format 调用IsMediaTypeSupported()选第一个成功者若全失败降级到MFVideoFormat_RGB24640x480确保基础功能可用。4.2 现象预览画面静止ReadSample一直返回MF_E_TRANSFORM_NEED_MORE_INPUT原因IMFSourceReader内部缓冲区已满但你的代码没及时Release()IMFSample对象。COM 引用计数未归零MF 拒绝提供新帧。解决每次ReadSample后无论是否处理必须调用sample?.Release()在StartPreviewLoopAsync的catch块中也要确保sample?.Release()使用using无法管理 COM 对象必须显式Release()。4.3 现象录像文件生成但 VLC 播放显示“no video track”原因IMFSinkWriter未正确调用NotifyEndOfStream()或WriteSample()传入的IMFSample时间戳qwSampleTime为 0。解决WriteSample()前必须设置sample.SetSampleTime(currentTimestamp)时间戳单位为 100ns停止录像时先调用sinkWriter.NotifyEndOfStream(streamIndex)再sinkWriter.Finalize()Finalize()后sinkWriter对象必须Release()否则文件句柄未关闭VLC 无法读取索引。4.4 现象Win10 企业版/教育版上程序启动即报MF_E_SHUTDOWN原因系统组策略禁用了 Media FoundationComputer Configuration → Administrative Templates → Windows Components → Media Foundation → Turn off Media Foundation。解决程序启动时MFStartup后立即调用MFGetSystemId()若返回E_FAIL弹窗提示“请检查组策略中 Media Foundation 是否启用”不要尝试绕过这是系统级限制强行调用会崩溃。4.5 现象多摄像头同时打开时第二个MediaCapture构造失败原因MFStartup是进程级单例但IMFSourceReader创建时Windows 驱动可能锁定设备。解决在EnumerateDevices()后为每个设备缓存deviceSymbolicLink并记录MFVideoFormat_*支持列表多实例时确保每个MediaCapture使用不同的设备路径若必须同设备多路输出改用IMFTransform做一分二而非创建两个SourceReader本项目未实现但架构上可扩展。5. 二次开发实战从“能用”到“好用”的三步改造法5.1 第一步增加自动对焦与曝光控制调用IAMVideoProcAmp原生 MF 不直接暴露对焦但可通过IMFSourceReader获取底层IBaseFilter再 QueryInterface 到IAMVideoProcAmp。改造MediaCapture.cs// 在构造函数中SourceReader 创建后追加 private void EnableHardwareControls() { // 1. 获取 IBaseFilter需先 QueryInterface IMFGetService var hr _sourceReader.GetService( MFConstants.MF_SERVICE_SOURCE_READER, typeof(IBaseFilter).GUID, out var pUnk); MFErrorHelper.ThrowExceptionOnFailure(hr, GetService IBaseFilter failed); hr pUnk.QueryInterface(typeof(IAMVideoProcAmp).GUID, out var procAmp); if (hr 0) // S_OK or S_FALSE { // 2. 设置对焦值范围 0-100000无穷远10000最近 hr ((IAMVideoProcAmp)procAmp).SetRange( VideoProcAmpProperty.Focus, 0, 10000, 1, 0, 0); // min, max, step, default, flags hr ((IAMVideoProcAmp)procAmp).Set( VideoProcAmpProperty.Focus, 5000, // 中间值 VideoProcAmpFlags.Manual); } }提示IAMVideoProcAmp是 DirectShow 接口但现代摄像头驱动仍兼容。若QueryInterface失败说明该设备不支持硬件控制跳过即可。5.2 第二步录像时添加时间戳水印GDI 动态绘制VideoPanel.cs的OnPaint只负责预览录像需在SinkWriterWrapper.WriteSample()中注入水印。改造思路在WriteSample()中从IMFSample提取IMFMediaBufferLock()后用System.Drawing.Bitmap加载 RGB24 数据Graphics.DrawString()绘制当前时间DateTime.Now.ToString(HH:mm:ss)将 Bitmap 数据拷回IMFMediaBuffer注意 BGR 顺序Unlock()并WriteSample()。关键代码SinkWriterWrapper.cspublic void WriteSample(IMFSample sample, long timestamp) { // ... 原有代码获取 buffer, Lock ... // 新增水印绘制 var bitmap new Bitmap(_width, _height, PixelFormat.Format24bppRgb); var bmpData bitmap.LockBits( new Rectangle(0, 0, _width, _height), ImageLockMode.ReadWrite, PixelFormat.Format24bppRgb); // 将 pbBufferBGR复制到 bmpData.Scan0RGB Marshal.Copy(pbBuffer, 0, bmpData.Scan0, (int)cbBuffer); using (var g Graphics.FromImage(bitmap)) { var font new Font(Arial, 16, FontStyle.Bold); var brush new SolidBrush(Color.Yellow); var now DateTime.Now.ToString(HH:mm:ss); g.DrawString(now, font, brush, 10, 10); } bitmap.UnlockBits(bmpData); // 此处需将 bitmap 数据拷回 pbBuffer略详见源码 Patch }血泪经验水印必须在WriteSample()中做不能在预览线程。因为预览是 RGB24录像编码器期望的输入也是 RGB24中途改数据格式会导致编码失败。5.3 第三步导出为 WebMVP9以适配网页端MP4 是通用格式但若需在网页video中直接播放WebMVP9体积更小、免版权费。只需替换SinkWriterWrapper中的 subtype 和参数// 替换 MFVideoFormat_H264 为 MFVideoFormat_VP90 guidSubtype MFConstants.MFVideoFormat_VP90; // 设置 VP9 特有属性 attributes.SetUINT32(MFConstants.MF_MT_VP9_PROFILE, 0); // Profile 0 attributes.SetUINT32(MFConstants.MF_MT_AVG_BITRATE, 1 * 1000 * 1000); // 1Mbps然后MFCreateSinkWriterFromURL的路径改为*.webm。Windows 10 1809 原生支持 VP9 编码无需额外 codec。从那以后我每次新增硬件控制或格式支持都强制走一遍“设备枚举 → 格式探测 → 最小可行录制 → 日志验证”四步闭环。不是为了炫技而是因为 Windows API 的文档永远比实际行为少两页——只有亲手把IMFMediaEventGenerator的MESourceStarted事件打出来你才真正相信这帧数据是从那个 USB 口进来的。希望帮到你。本文还有配套的精品资源点击获取