如何拦截Microsoft Teams通话网络质量不佳通知并解决COM连接超时问题

问题背景 #

在Windows环境下，需要拦截Microsoft Teams通话时弹出的网络质量不佳通知，用于网络诊断（测试时用clumsy模拟网络波动）。已定位到C:\Users\xxx\AppData\Local\Microsoft\TeamsPresenceAddin\Uc.tlb类型库，其中ModalityProperty枚举包含ucAVModalityAudioNetworkQuality（0x300b001d）和ucAVModalityVideoNetworkQuality（0x300b0021），这两个枚举由AVModality coclass触发，通过_IAVModalityEvents接口对外通知。但尝试连接运行中的Teams实例（试过ROT但未注册）、枚举模态获取AVModality并订阅事件时，遇到DCOM超时错误：

"The server {00425F68-FFC1-445F-8EDF-EF78B84BA1C7} did not register with DCOM within the required timeout."

一、解决DCOM超时与Teams实例连接问题 #

• 检查并修复Teams的COM注册
  Teams默认不会把主进程注册到ROT或DCOM，先去注册表HKEY_CLASSES_ROOT\CLSID\{00425F68-FFC1-445F-8EDF-EF78B84BA1C7}确认是否存在。如果找不到，试试：

  1. 以管理员身份重启Teams，触发自动注册；
  2. 找到Teams安装目录下的相关COM DLL（比如TeamsPresenceAddin.dll），用对应位数的regsvr32.exe手动注册（32位用C:\Windows\SysWOW64\regsvr32.exe，64位用C:\Windows\System32\regsvr32.exe）。

• 调整DCOM超时参数
  打开dcomcnfg.exe（组件服务），找到对应CLSID的组件（已注册的话），右键属性→「常规」标签，把默认超时调大。或者在代码里通过CoInitializeSecurity手动设置：

  CoInitializeSecurity(
      IntPtr.Zero,
      -1,
      IntPtr.Zero,
      IntPtr.Zero,
      RPC_C_AUTHN_LEVEL_DEFAULT,
      RPC_C_IMP_LEVEL_IMPERSONATE,
      IntPtr.Zero,
      EOAC_NONE,
      IntPtr.Zero);
  

• 改用进程内注入获取实例
  Teams的Presence Addin是进程内组件，跨进程DCOM调用容易超时，不如直接把代码注入到Teams进程里：
  用EasyHook这类工具写注入程序，在Teams进程内加载转换后的Uc.tlb程序集，直接获取AVModality实例，避免跨进程通信的问题。

二、枚举模态并订阅网络质量事件 #

• 正确转换类型库
  用TlbImp.exe转换Uc.tlb时指定命名空间，避免冲突：

  TlbImp.exe Uc.tlb /namespace:Microsoft.Teams.Uc /out:Microsoft.Teams.Uc.dll
  

• 订阅事件的核心代码
  在注入的代码里，获取AVModality实例后，通过连接点订阅事件：

  // 从Teams进程内部获取AVModality实例（需结合注入逻辑实现GetAVModalityFromTeams）
  var avModality = GetAVModalityFromTeams();
  var eventSink = new AVModalityEventSink();
  
  var connectionPointContainer = (IConnectionPointContainer)avModality;
  Guid eventGuid = typeof(_IAVModalityEvents).GUID;
  connectionPointContainer.FindConnectionPoint(ref eventGuid, out var connectionPoint);
  connectionPoint.Advise(eventSink, out var cookie);
  

• 实现事件接收器
  写个类处理网络质量变化事件：

  public class AVModalityEventSink : _IAVModalityEvents_Event
  {
      public void OnPropertyChange(ModalityProperty property, object value)
      {
          if (property == ModalityProperty.ucAVModalityAudioNetworkQuality || 
              property == ModalityProperty.ucAVModalityVideoNetworkQuality)
          {
              // 这里替换成你的诊断逻辑，比如记录日志、拦截原生通知
              int qualityLevel = (int)value;
              Console.WriteLine($"[{property}] 网络质量等级：{qualityLevel}");
          }
      }
  
      // 接口其他方法按需实现（如果编译器报错的话）
  }
  

三、测试验证 #

用clumsy开启网络波动模拟（比如丢包10%、延迟200ms），启动Teams通话，检查事件接收器是否能捕获到网络质量变化，以此替代原生的弹窗通知。

内容的提问来源于stack exchange，提问作者Andrei Georgescu