(Windows Media Format 11 SDK) 注册应用程序依赖项

[与此页面关联的功能 Windows Media Format 11 SDK 是旧版功能。 它已被源读取器和接收器编写器取代。 源读取器和接收器编写器已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用源读取器和接收器编写器,而不是 Windows Media Format 11 SDK。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

使用 Windows Media Format SDK 或 Windows 媒体播放器 SDK 提供的 API 的应用程序依赖于这些技术的运行时组件。 可以在应用程序设置过程中将应用程序注册为依赖于这些组件。

注册应用程序时,可以选择两个依赖项级别之一:阻止或依赖。 当一个或多个应用程序注册到其中一个运行时组件的阻塞依赖项时,将阻止该组件从回滚到以前的版本。 未注册为阻止的依赖应用程序不阻止回滚。 相反,在执行回滚之前,系统会提示用户显示一条消息,指出应用程序依赖于组件。

若要注册应用程序,必须在注册表中设置标识应用程序的值。 要设置的注册表值取决于应用程序所依赖的组件。 还可以为每个依赖项设置两个附加值,以提供有关应用程序的额外信息。

以下注册表值用于注册对 Windows Media Format SDK 运行时的依赖关系:

  • HKEY_CLASSES_ROOT\Software\Microsoft\WindowsMedia\Setup\REF_TYPE\App、“APP”、“APP_STRING
  • HKEY_CLASSES_ROOT\Software\Microsoft\WindowsMedia\Setup\REF_TYPE\描述符、“APP”、“REF_DESCRIPTOR
  • HKEY_CLASSES_ROOT\Software\Microsoft\WindowsMedia\Setup\REF_TYPE\Version,“APP”、“WMF_VERSION

以下注册表值用于注册对 Windows 媒体播放器 SDK 运行时的依赖关系:

  • HKEY_CLASSES_ROOT\Software\Microsoft\MediaPlayer\Setup\REF_TYPE\App、“APP”、“APP_STRING
  • HKEY_CLASSES_ROOT\Software\Microsoft\MediaPlayer\Setup\REF_TYPE\描述符、“APP”、“REF_DESCRIPTOR
  • HKEY_CLASSES_ROOT\Software\Microsoft\MediaPlayer\Setup\REF_TYPE\Version,“APP”、“WMP_VERSION

以下变量用于上面列出的注册表值:

REF_TYPE

将 替换为 BlockingRefCounts(用于阻止依赖项),将 替换为 DependentRefCounts(用于非阻塞依赖项)。

APP

应用程序的名称或短描述符。 此字符串不会在为用户显示的消息中使用。 此值是与每个运行时组件关联的所有三个注册表值中使用的标识符。

APP_STRING

应用程序的描述符。 此字符串可用于为用户显示的消息。

REF_DESCRIPTOR

应用程序如何使用组件的说明。 此值最多可以包含 256 个字符。

WMP_VERSION

应用程序所需的Windows 媒体播放器版本。

WMF_VERSION

应用程序所需的 Windows Media Format SDK 版本。

以下三个示例注册表值演示如何为应用程序配置值:

  • HKEY_CLASSES_ROOT\Software\Microsoft\WindowsMedia\Setup\DependentRefCounts\App,“南岭视频”,“南岭视频播放器”
  • HKEY_CLASSES_ROOT\Software\Microsoft\WindowsMedia\Setup\DependentRefCounts\Descriptor“SouthridgeVideo”、“Southridge Video Player 使用 Windows Media Format SDK 播放视频文件”。
  • HKEY_CLASSES_ROOT\Software\Microsoft\WindowsMedia\Setup\DependentRefCounts\Version, “SouthridgeVideo”, “9.0.0.2600”

项目注意事项