Media Foundation Codecs注册失败导致解码器不可用？

Question

Media Foundation Codecs注册失败导致解码器不可用，是Windows平台多媒体开发与部署中的典型问题。常见诱因包括：注册表项（如`HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows Media Foundation\Transforms`）权限不足或被误删；32/64位Codec DLL未在对应体系结构下正确注册（如x64系统未运行`regsvr32 /regserver`于64位DLL）；依赖的VC++运行库或Windows SDK组件缺失；或MF插件（MFT）未实现`IMFTransform`接口合规性，致使`MFStartup()`后`MFTEnumEx()`返回空列表。此外，沙盒环境（如AppContainer）、组策略禁用自定义MFT，或Windows更新重置MF配置亦可能触发该故障。诊断时建议结合`mftrace`日志、`mfplat.dll`加载跟踪及`MFTEnumEx`调用返回码（如`MF_E_TOPOLOGY_NO_VALID_OUTPUT`）精准定位。修复需确保注册完整性、架构匹配性与依赖完备性，而非仅重启服务。

Answer 1

```html

一、现象层：解码器“消失”——MF应用启动后无法枚举任何MFT

典型表现：调用 MFStartup(MF_VERSION, MFSTARTUP_FULL) 成功，但紧随其后的 MFTEnumEx(MFT_CATEGORY_VIDEO_DECODER, ...) 返回空数组或错误码（如 MF_E_TOPOLOGY_NO_VALID_OUTPUT 或 MF_E_UNSUPPORTED_SERVICE）。媒体会话构建失败，IMFTopologyNode::SetUnknown 设置解码器节点时抛出异常。此非UI卡顿或性能问题，而是MF基础设施层的“服务不可见”状态。

二、注册层：注册表键缺失或权限失控

• 关键路径：HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows Media Foundation\Transforms（64位）与 HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows Media Foundation\Transforms（32位）必须共存且结构完整
• 常见破坏场景：杀毒软件清理“可疑注册表项”、域策略脚本误删、手动导出/导入注册表时忽略架构差异
• 权限验证命令：icacls "HKLM\SOFTWARE\Microsoft\Windows Media Foundation" /verify —— 若提示 ACCESS DENIED，则 SYSTEM 或 Administrators 缺失 F（完全控制）权限

三、架构层：DLL注册的“位宽陷阱”

在x64 Windows上，存在两套独立注册机制：

架构	regsvr32路径	目标DLL位置	注册表写入位置
x64	%SystemRoot%\System32\regsvr32.exe	C:\Windows\System32\MyDecoder64.dll	HKLM\...\Transforms\{CLSID}\...（主干）
x86	%SystemRoot%\SysWOW64\regsvr32.exe	C:\Windows\SysWOW64\MyDecoder32.dll	HKLM\WOW6432Node\...\Transforms\...

四、依赖层：静默崩溃的“隐形链条”

MF插件并非孤立运行。以下任一缺失均导致 DllGetClassObject 失败，进而使 MFTEnumEx 跳过该CLSID：

• 对应版本VC++ Redistributable（如 v143 对应 VS2022，需检查 vcruntime140.dll, msvcp140.dll 是否可加载）
• Windows SDK Media Foundation 运行时组件（mf.dll, mfplat.dll, mfsensorgroup.dll 版本需 ≥ 应用编译时所用SDK）
• 若使用DirectX Math或WIC解码前置处理，还需 d3dcompiler_47.dll 和 WindowsCodecs.dll

五、合规层：IMFTransform实现的“契约违约”

即使注册成功，若MFT未满足MF平台契约，仍将被 MFTEnumEx 屏蔽。核心校验点包括：

1. 必须导出 DllGetClassObject 并正确返回 IClassFactory
2. IMFTransform::GetStreamCount() 必须返回非零输入/输出流数
3. IMFTransform::GetStreamIDs() 不得返回 E_NOTIMPL（除非仅单流）
4. 必须支持至少一组 MF_MT_SUBTYPE（如 MFVideoFormat_H264）且 IMFTransform::GetOutputAvailableType() 可枚举

六、环境层：沙盒与策略的“合法封禁”

graph TD A[App启动] --> B{是否运行于AppContainer?} B -->|是| C[MF仅允许白名单MFT
如 H.264 Decoder MFT] B -->|否| D{组策略检查} D --> E[Computer Config → Admin Templates → Windows Components → Media Foundation → “Allow custom MFTs” = Enabled?] D --> F[若Disabled，则所有第三方CLSID被过滤] E --> G[Windows Update KB5034441后默认启用MF策略审计]

七、诊断工具链：从日志到堆栈的纵深追踪

推荐组合诊断流程：

1. 启用 mftrace：运行 mftrace -enable -level 4 -file mflog.etl，复现问题后用 mftrace -decode mflog.etl > mflog.txt
2. 监控DLL加载：使用 Process Monitor 过滤 mfplat.dll, mf.dll, YourCodec.dll 的 NAME NOT FOUND 或 PATH NOT FOUND
3. 验证MFT枚举：用 MFEnumTest.exe（Windows SDK示例）直接调用 MFTEnumEx 并打印返回码与CLSID列表

八、修复矩阵：按根因分类的精准处置方案

根因类别	验证命令	修复操作
注册表缺失	reg query "HKLM\SOFTWARE\Microsoft\Windows Media Foundation\Transforms"	导入官方备份注册表，或用 mfinstall.exe /register（Win10+ SDK提供）
架构错配	dumpbin /headers YourCodec.dll | findstr machine	确认machine为 AMD64 或 IX86，再匹配 regsvr32 路径执行

九、验证闭环：不止于“能跑”，更要“合规运行”

修复后必须完成三级验证：

1. 注册级：通过 regsvr32 /query YourCodec.dll 确认CLSID已写入对应注册表分支
2. 加载级：用 Dependency Walker 或 Dependencies.exe 打开DLL，确认无红色缺失模块
3. MF级：编写最小测试程序，调用 MFTEnumEx → CoCreateInstance → IMFTransform::ProcessInput 模拟一帧解码

十、防御性实践：面向生产环境的MF部署规范

• 禁止在用户态直接调用 regsvr32；改用 MSI 安装包，通过 CustomAction 在 InstallExecuteSequence 中以 SYSTEM 权限注册
• 在安装前强制检查 mfplat.dll 版本：GetFileVersionInfoSize + VerQueryValue ≥ “10.0.19041.0”（Win10 2004）
• 为AppContainer应用预生成 Package.appxmanifest 中的 uap:Capability Name="videoExtension" 声明
• 将 mftrace 日志采集集成至应用崩溃上报管道，自动提取 MFTEnumEx 返回码上下文

```