示例工程【免费下载链接】Windows-driver-samplesThis repo contains driver samples prepared for use with Microsoft Visual Studio and the Windows Driver Kit (WDK). It contains both Universal Windows Driver and desktop-only driver samples.项目地址https://gitcode.com/gh_mirrors/wi/Windows-driver-samples点击查看免费下载导读本文以 avstream/samplemft0 为例系统讲解 Windows 驱动开发者如何实现一个Driver MFT又称 MFT0——即摄像头视频捕获管线中第一个被应用的 Media Foundation Transform。读完本文你将掌握 MFT0 的概念定位、面向 UWP 设备应用的控制接口设计、IMFTransform 全接口实现套路、视频帧逐行处理原理以及如何将 MFT0 随驱动包分发并用于实现实时视频特效。一、什么是 Driver MFTMFT0在 Windows 10 及以上的摄像头驱动架构中当应用通过 Media FoundationMF从摄像头捕获视频时视频流会经过一串变换Transform。Driver MFT 是这一串变换中第一个被应用到摄像头视频流的 MFT因此也常被称为MFT0。它在设备驱动侧运行随摄像头驱动包一起分发属于“驱动扩展”而非纯应用层组件它可以在从摄像头捕获照片或视频时提供视频特效或其他图像处理并且无需修改驱动本身它的启用、参数调节可以交由配套的UWP 设备应用UWP device app来控制。在 README 中官方给出的定位描述是“A driver MFT is a Media Foundation Transform thats used with a specific camera when capturing video … It can be distributed along with the driver package for a camera.”也就是说MFT0 是与某个特定摄像头绑定的它只在系统识别到该摄像头并开始捕获时才被加载。二、示例效果绿色/纯色框替换视频局部本示例的演示效果非常直观当 MFT0 被启用时它会把捕获视频的一部分替换为一个纯色框README 描述为 green box。剩余画面原样透传从而证明MFT0 已成功挂接到摄像头捕获管线MFT0 有能力对每一帧视频数据做实际的像素级改写特效的开启与范围可以由外部UWP 设备应用动态控制。从源码看这一效果在CMft0::OnProcessOutput中实现Mft0.cpp输入帧与输出帧分别被锁定后按行复制像素凡位于lines阈值之下的行即画面底部区域用memset填零形成一个纯色块其余行memcpy原样拷贝。lines由成员变量m_percentOfScreen默认 50即画面 50%计算long lines uiHeight; if(m_percentOfScreen ! -1 m_percentOfScreen ! 0) { lines (UINT)(uiHeight * (1.0 - m_percentOfScreen / 100.00)); }注意当m_percentOfScreen为-1或0时lines uiHeight整帧被完整透传相当于特效关闭因此 UWP 设备应用可以通过把该值设为 0 来“消除”遮挡。框的“颜色”对应零值填充数据开发者可自行替换为任意 RGB 填充逻辑以实现真正的绿色或其他颜色框。三、运行与测试的前提条件README 明确列出要真正运行本示例需要以下配套条件缺一不可前提说明配套 UWP 设备应用Device app for camera sample提供 UWP 设备应用用于控制 Driver MFT 实现的特效即调用本文第五节介绍的 IMft0 控制接口摄像头捕获 UI 示例Camera Capture UI sample提供一种方式去调用上述 UWP 设备应用从而在真实拍摄界面里看到特效开关效果特定摄像头的设备 ID本示例“绑定”特定相机运行时需要相机的设备 ID 才能把 MFT0 关联到该设备设备元数据包device metadata package用于把 UWP 设备应用与特定摄像头关联起来是设备应用被系统按设备调用的关键也就是说MFT0 本身无法独立演示——它必须与 UWP 设备应用、捕获 UI 以及一台具体摄像头或对应的模拟环境组成完整链路。构建与部署时还需将生成的 DLL 放进相机的驱动包见下文打包章节。四、工程结构与构建方式4.1 文件清单avstream/samplemft0/目录下各文件职责如下文件职责Mft0.cpp / Mft0.hCMft0类的全部实现IMFTransform 各方法、IMft0 控制方法、图像处理核心SampleMft0.idlMIDL 接口定义声明IMft0控制接口与Mft0coclass、类型库 GUIDSampleMft0.cppDLL 导出入口DllCanUnloadNow、DllGetClassObject、DllRegisterServer等SampleMft0.def模块导出表声明上述 5 个 DLL 导出函数SampleMft0.rgs / Mft0.rgsATL 注册脚本写入 COM CLSID、InprocServer32、ThreadingModel 等注册表项dllmain.cpp / dllmain.hDllMain与 ATL 模块类CSampleMft0ModuleSampleHelpers.h公共辅助错误检查宏、VideoBufferLock缓冲锁定工具类SampleMft0.vcxproj主工程产出SampleMft0.dllPackage/package.vcxproj打包工程产出驱动安装包SampleMft0.sln解决方案包含上述两个工程4.2 构建配置要点从 SampleMft0.vcxproj 可以看到使用 WDK 的WindowsApplicationForDrivers10.0工具集ConfigurationType为DynamicLibrary生成 DLL支持x64 与 ARM64两种平台Debug/Release 均以Windows 10为目标版本输出目标名TargetName为SampleMft0即最终产物为SampleMft0.dll。Package/package.vcxproj 则以WindowsKernelModeDriver10.0工具集、DriverType为Package的 Utility 工程形式将生成的 DLL 与驱动包元数据一起封装便于随相机驱动包分发。这正对应 README 中“driver MFT 可以随相机驱动包一起分发”的定位。五、核心源码剖析5.1 COM 对象模型一个类三重身份CMft0Mft0.h基于 ATL 实现同时实现三个接口class ATL_NO_VTABLE CMft0 : public CComObjectRootExCComMultiThreadModel, public CComCoClassCMft0, CLSID_Mft0, public IMft0, // 面向 UWP 设备应用的控制接口 public IMFTransform, // Media Foundation Transform 核心接口 public IInspectable // WinRT 可检查性接口IMFTransform让对象成为标准 MFT被媒体管线按 Transform 协议调用IMft0示例自定义的控制接口供 UWP 设备应用调用见 5.2IInspectable使对象可作为 WinRT 对象被元数据检查GetIids、GetRuntimeClassName、GetTrustLevel其中信任级别返回BaseTrust见 Mft0.cpp。构造函数初始化了关键状态m_bEnableEffects TRUE、m_percentOfScreen 50并创建临界区m_critSec保护所有状态所有核心方法都通过EnterCriticalSection/LeaveCriticalSection保证线程安全。5.2 控制接口 IMft0UWP 设备应用如何遥控特效SampleMft0.idl 定义了四个方法其语义与实现Mft0.cpp一一对应interface IMft0 : IUnknown{ [id(1)] HRESULT UpdateDsp([in] UINT32 uiPercentOfScreen); [id(2)] HRESULT Enable(void); [id(3)] HRESULT Disable(void); [id(4)] HRESULT GetDspSetting([out] UINT* puiPercentOfScreen, [out] BOOL* pIsEnabled); };方法作用实现要点UpdateDsp(uiPercentOfScreen)设置特效覆盖屏幕的比例0~1000 或 -1 表示全透传直接写入m_percentOfScreenEnable()开启特效置m_bEnableEffects TRUEDisable()关闭特效置m_bEnableEffects FALSEGetDspSetting(...)查询当前比例与开关状态同时回读m_percentOfScreen与m_bEnableEffects这就是 README 所说“UWP 设备应用控制 Driver MFT 实现的特效”的底层通道设备应用拿到 MFT0 对象后通过这 4 个方法即可实时调整画面中色块的大小和开关无需重启捕获会话。5.3 流模型固定 1 进 1 出CMft0是一个最简单的单进单出 MFTGetStreamLimits返回输入/输出均为最小 1、最大 1Mft0.cppGetStreamCount同样返回 1 进 1 出GetStreamIDs直接返回E_NOTIMPL表示流 ID 固定为 0按 MFT 协议单流 MFT 可省略流 IDIsValidInputStream/IsValidOutputStream均只接受dwInputStreamID 0。输入流信息声明了MFT_INPUT_STREAM_WHOLE_SAMPLES | MFT_INPUT_STREAM_SINGLE_SAMPLE_PER_BUFFER输出流声明了MFT_OUTPUT_STREAM_WHOLE_SAMPLES | MFT_OUTPUT_STREAM_SINGLE_SAMPLE_PER_BUFFER | MFT_OUTPUT_STREAM_PROVIDES_SAMPLES | MFT_OUTPUT_STREAM_FIXED_SAMPLE_SIZE——即每个样本携带一整帧且 MFT 自行提供输出样本见 GetInputStreamInfo 与 GetOutputStreamInfo。5.4 与底层相机源的绑定MFT0 之所以能拿到“这个摄像头支持的媒体类型”关键在于它通过输入流属性反向找到底层相机源从输入属性中读取MFT_CONNECTED_STREAM_ATTRIBUTEMft0.cpp再从该属性中取出MF_DEVICESTREAM_EXTENSION_PLUGIN_CONNECTION_POINTQueryInterface得到IMFTransform类型的m_pSourceTransform——即相机的源变换读取MF_DEVICESTREAM_STREAM_CATEGORY判断流类型代码打印PINNAME_VIDEO_CAPTURE/PINNAME_VIDEO_PREVIEW/PINNAME_VIDEO_STILL/PINNAME_IMAGE并且只接受PINNAME_VIDEO_PREVIEW或PINNAME_VIDEO_CAPTURE其他类型返回E_UNEXPECTED调用GenerateMFMediaTypeListFromDeviceMft0.cpp遍历源变换的所有GetOutputAvailableType筛出可处理的视频格式后存入m_listOfMediaTypes。GetInputAvailableType/GetOutputAvailableType之后都从m_listOfMediaTypes返回候选媒体类型GetMediaTypeMft0.cpp。SetInputType则通过IsMediaTypeSupported校验支持MFT_SET_TYPE_TEST_ONLY试设模式并把完整媒体类型同时缓存为输入/输出类型。5.5 数据流ProcessInput → ProcessOutput处理流程是 MFT 的教科书式实现ProcessInputMft0.cpp校验流 ID、校验类型已设置否则MF_E_NOTACCEPTING、校验缓冲数0 个返回E_FAIL多于 1 个返回MF_E_SAMPLE_HAS_TOO_MANY_BUFFERS然后缓存输入样本m_pSample并 AddRefGetInputStatus / GetOutputStatusMft0.cpp以m_pSample是否为 NULL 作为是否可接受输入/是否有输出就绪的唯一判据ProcessOutputMft0.cpp无缓存样本时返回MF_E_TRANSFORM_NEED_MORE_INPUT否则创建输出样本、把输入/输出缓冲转成连续缓冲调用OnProcessOutput做像素处理并将输入样本的时间戳与时长拷贝到输出样本后释放输入样本ProcessMessageMft0.cppMFT_MESSAGE_COMMAND_FLUSH触发OnFlush释放缓存样本MFT_MESSAGE_COMMAND_DRAIN无需额外动作MFT_MESSAGE_SET_D3D_MANAGER返回E_NOTIMPL未声明 D3D 感知。5.6 像素级处理帧格式、stride 与 VideoBufferLockOnProcessOutput只在m_bEnableEffects为 TRUE 且子类型属于受支持的 29 种视频格式时才做处理格式清单涵盖RGB 系RGB8、RGB555、RGB565、RGB24、RGB32、ARGB32、AI44YUV 平面/半平面I420、IYUV、NV11、NV12、YV12、P010、P016、P210、P216YUV 打包/交织AYUV、UYVY、Y41P、Y41T、Y42T、YUY2、v210、v216、v410、Y210、Y216、Y410、Y416。完整条件见 Mft0.cpp 与 GenerateMFMediaTypeListFromDevice。行步长stride的处理是本例最值得借鉴的部分GetDefaultStrideMft0.cpp优先读取MF_MT_DEFAULT_STRIDE未设置时用MFGetStrideForBitmapInfoHeader按子类型与宽度计算并回写属性缓存SampleHelpers.h 中的VideoBufferLock封装了缓冲锁定优先QueryInterface到IMF2DBuffer走Lock2D否则走IMFMediaBuffer::Lock并处理bottom-up负 stride返回内存中最后一行即图像顶行与 top-down 两种布局OnProcessOutput按行memcpy上半部分、memset下半部分同时正确处理负 stride 场景Mft0.cpp。这一套“默认 stride 计算 2D 缓冲回退 方向处理”的模式是编写任何逐像素 MFT 的通用基础设施。5.7 全局属性异步关闭、动态格式更改与硬件 URLGetAttributesMft0.cpp创建并返回三个关键属性属性值含义MF_TRANSFORM_ASYNCFALSEMFT 为同步处理模式管线按传统 ProcessInput/ProcessOutput 轮询MFT_ENUM_HARDWARE_URL_AttributeLSample_CameraExtensionMft硬件 MFT 枚举 URL供系统按名称识别/枚举该扩展 MFTMFT_SUPPORT_DYNAMIC_FORMAT_CHANGETRUE支持动态格式更改配合SetInputType的校验逻辑输入流属性同样携带MFT_SUPPORT_DYNAMIC_FORMAT_CHANGE与相同的硬件 URLMft0.cpp。需要说明的是虽然示例在全局/输入属性中声明支持动态格式更改SetOutputType只是转发到SetInputType且DeleteInputStream/AddInputStreams均返回E_NOTIMPL——流数量固定不允许动态增删。六、COM 注册与驱动打包Mft0.rgs 注册CLSID {7BB640D9-33A4-4759-B290-F41A31DCF848}Mft0 ClassInprocServer32指向%MODULE%ThreadingModel为Both并关联类型库{DE05674A-C564-4C0E-9B7C-E1519F7AA767}SampleMft0Libv1.0类型库与 coclass 定义见 SampleMft0.idlOBJECT_ENTRY_AUTOMft0.h让 ATL 在DllRegisterServer时自动写入这些项SampleMft0.def 仅导出 5 个标准 COM 入口DllRegisterServer/DllUnregisterServer/DllInstall实现在 SampleMft0.cpp。部署层面编译出的SampleMft0.dll通过 Package 工程DriverTypePackage与相机驱动包一起封装、签名并分发——这正是 README 强调的“随驱动包分发”能力。在实际驱动安装时还需要在设备的驱动扩展配置inf 中引用 MFT0 CLSID/硬件 URL中声明该 MFTMFT0 才会在该相机捕获时被管线加载。七、测试链路与配套示例按照 README 的说明验证本示例的完整链路为构建SampleMft0.sln得到SampleMft0.dll并随驱动包安装到目标相机部署Device app for camera sampleUWP 设备应用它在拍摄界面里通过IMft0调用Enable/Disable/UpdateDsp/GetDspSetting实现对特效的实时控制运行Camera Capture UI sample它作为宿主捕获界面调用 UWP 设备应用让用户能直观看到“画面中一部分被色块替换/恢复”的效果前提是拥有该相机的设备 ID与设备元数据包系统才会把 UWP 设备应用与这台相机、这个 MFT0 关联起来。在调试阶段代码内置了流类型打印wprintf(LStream type: PINNAME_VIDEO_CAPTURE\n)等与CHK_LOG_BRK错误宏SampleHelpers.h 输出HR%08x File: %S Ln: %d配合调试器即可确认 MFT0 是否被正确挂接、媒体类型协商是否成功。八、相关主题与延伸阅读摄像头 UWP 设备应用设计Device app for cameras本示例配套设备应用的控制主体Media Foundation TransformsIMFTransform接口与 MFT 处理协议本文 5.3~5.5 节即其实战实现Streaming media device driver design guide摄像头驱动与流媒体设备驱动设计对应本文 5.4 节“与底层源变换绑定”机制Universal camera driver design guideWindows 10 通用摄像头驱动设计解释了 MFT0 在通用相机驱动架构中的挂载位置。如需深入可继续阅读本仓库中avstream/samplemft0/目录下的 Mft0.cpp、Mft0.h、SampleMft0.idl 与 SampleHelpers.h对照本文各节即可获得完整的源码级证据链。赞分享示例工程【免费下载链接】Windows-driver-samplesThis repo contains driver samples prepared for use with Microsoft Visual Studio and the Windows Driver Kit (WDK). It contains both Universal Windows Driver and desktop-only driver samples.项目地址https://gitcode.com/gh_mirrors/wi/Windows-driver-samples点击查看免费下载相关推荐Stoic模型数据预处理如何准备FASTA文件进行化学计量预测Stoic模型数据预处理如何准备FASTA文件进行化学计量预测 Stoic模型HuggingFace镜像/PickyBinders是一款强大的化学计量预测Obsidian美化终极指南从基础到高级的完整个性化方案Obsidian美化终极指南从基础到高级的完整个性化方案 Obsidian作为一款功能强大的Markdown笔记工具其核心魅力不仅在于强大的知识管理能力更文档知识管理libusb摄像头设备通信基于UVC协议的视频流采集方案libusb摄像头设备通信基于UVC协议的视频流采集方案 引言突破USB摄像头开发的底层难题 你是否曾在开发USB摄像头应用时遭遇这些困境调用系统API时驱动开发系统编程上一篇Zotero Style插件终极指南如何通过可视化界面提升文献管理效率50%下一篇终极代码助手Qwen2.5-Coder-1.5B-Instruct-GGUF的8大核心功能与实战案例创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
