Media Foundation视频捕获引擎设备断开时文件损坏及接口调用失败求助

问题分析 #

1. 分辨率绑定的流资源异常：640x480是多数USB摄像头的默认分辨率，Media Foundation Capture Engine在该分辨率下可能会复用摄像头内置的硬件编码通道，导致流资源与设备硬件强绑定。当设备突然断开，流资源被强制回收，此时调用CaptureSink->RemoveAllStreams()时，底层无法定位有效流对象，直接触发调用失败。
2. MP4文件关键结构未写入：MP4文件的核心索引信息（moov原子）通常在录制正常结束时才会写入文件尾部。设备意外断开时，Capture Engine未能触发正常停止流程，导致moov原子缺失，文件结构不完整——虽然文件大小因未写入的缓存数据增加，但播放器无法识别有效索引，因此报错“不支持的文件”。
3. 编码器缓存未清空冲突：部分硬件编码器在640x480分辨率下会启用大帧缓存优化性能，设备断开时，缓存中的未编码帧无法被处理写入，同时编码器仍持有流资源，导致RemoveAllStreams()调用时出现资源占用冲突，返回失败。

解决办法 #

• 主动监听设备插拔事件：使用Windows的RegisterDeviceNotificationAPI注册USB设备通知，在检测到摄像头断开的第一时间主动触发录制停止流程：
  1. 调用CaptureEngine->StopRecord()，等待异步停止回调完成；
  2. 调用CaptureEngine->Shutdown()；
  3. 最后再处理Sink的流移除操作。
     这种方式避免了设备断开后被动处理异常状态。
• 调整流移除逻辑：放弃直接调用CaptureSink->RemoveAllStreams()，改为逐个移除流并忽略单个失败：

  DWORD streamCount = 0;
  CaptureSink->GetStreamCount(&streamCount);
  for (DWORD i = 0; i < streamCount; i++) {
      DWORD streamID = 0;
      CaptureSink->GetStreamIDByIndex(i, &streamID);
      // 忽略单个流移除失败，继续处理其他流
      CaptureSink->RemoveStream(streamID);
  }
  // 强制关闭Sink
  IMFMediaSink* pMediaSink = nullptr;
  CaptureSink->QueryInterface(IID_PPV_ARGS(&pMediaSink));
  pMediaSink->Shutdown();
  pMediaSink->Release();
  

• 手动补全MP4文件结构：若已出现文件损坏，可通过MF的MPEG4Sink接口尝试补全moov原子。在调用Sink的Shutdown()之前，强制调用IMFMediaSink->Finalize()（若接口支持），或根据MP4格式规范手动写入文件头和索引信息。
• 强制使用软件编码器：初始化Capture Engine时指定使用软件H.264编码器，避免硬件编码器与设备资源的绑定：

  MFT_REGISTER_TYPE_INFO videoType = { MFMediaType_Video, MFVideoFormat_H264 };
  IMFActivate** ppActivate = nullptr;
  UINT32 count = 0;
  MFTEnumEx(MFT_CATEGORY_VIDEO_ENCODER, MFT_ENUM_FLAG_SYNCMFT | MFT_ENUM_FLAG_LOCAL_MFT,
            &videoType, nullptr, &ppActivate, &count);
  // 选择软件编码器（通常名称包含"Software"）
  for (UINT32 i = 0; i < count; i++) {
      WCHAR szName[256] = { 0 };
      ppActivate[i]->GetAllocatedString(MFT_FRIENDLY_NAME_Attribute, &szName, nullptr);
      if (wcsstr(szName, L"Software") != nullptr) {
          // 使用该编码器初始化Sink
          break;
      }
  }
  

内容的提问来源于stack exchange，提问作者Jenny Jack