注册应用程序依赖项 (Windows 媒体播放器 SDK)

[与此页面关联的功能(Windows 媒体播放器 SDK)是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 如果可能,Microsoft 强烈建议新代码使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

使用 Windows 媒体播放器 SDK 或 Windows Media 格式 SDK 提供的 API 的应用程序依赖于这些技术的运行时组件。 可以将应用程序注册为依赖于这些组件,作为应用程序设置的一部分。

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

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

以下注册表值用于注册对 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

以下注册表值用于注册对 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

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

REF_TYPE

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

APP

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

APP_STRING

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

REF_DESCRIPTOR

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

WMP_VERSION

应用程序所需的Windows 媒体播放器版本。 如果未指定版本,则假定默认值为 9.0.0.0。

WMF_VERSION

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

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

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

注册表设置