通过

ConvertPluginCLSID 子项

  • 项目

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

当 Windows 媒体播放器 11 遇到自定义文件扩展名时，它会查找与扩展名匹配的注册表子项。 文件扩展名 注册表设置中介绍了子项。 在某些情况下，扩展的子项具有名为 ConvertPluginCLSID 的子项。

例如，假设你创建了一个文件扩展名为 .xyz) 的自定义文件格式 (，以及一个转换插件，用于将文件转换为 Windows 媒体播放器 然后，将插件的类 ID 存储在以下一个或两个子项中。

HKEY_LOCAL_MACHINE\Software\Microsoft\Multimedia\WMPlayer\Extensions\.xyz\ConvertPluginCLSID

HKEY_CURRENT_USER\Software\Microsoft\MediaPlayer\Player\Extensions\.xyz\ConvertPluginCLSID

ConvertPluginCLSID 子项指定插件的类 ID，Windows 媒体播放器可用于将媒体文件从其自定义格式转换为播放器支持的格式。

ConvertPluginCLSID 子项具有以下条目。

  • 表示默认转换插件的默认条目。
  • 表示默认转换插件的命名条目。
  • 其他表示备用转换插件的命名条目。

例如，假设自定义文件格式具有一个默认转换插件和两个备用转换插件。 ConvertPluginCLSID 子项下的注册表项将采用以下格式。

名称 类型 值
默认 REG_SZ 默认转换插件的类 ID（注册表格式）。
默认转换插件的类 ID（注册表格式）。 REG_SZ 默认转换插件的友好名称。
第一个备用转换插件的类 ID（采用注册表格式）。 REG_SZ 第一个备用转换插件的友好名称。
第二个备用转换插件的类 ID（采用注册表格式）。 REG_SZ 第二个备用转换插件的友好名称。

 

请注意，默认转换插件由两个注册表项表示：默认项和命名项。 Windows 媒体播放器使用默认条目来确定哪个插件是默认 (主) 转换插件。 Windows 媒体播放器使用命名条目来获取所有转换插件（包括默认插件）的友好名称。

转换插件的友好名称由创建插件的公司确定。 Windows 媒体播放器用户界面中可能会显示友好名称。

当Windows 媒体播放器尝试将文件从自定义格式转换为标准格式时，它首先加载默认插件。 如果默认插件无法转换文件并返回NS_E_WMP_CONVERT_PLUGIN_UNKNOWN_FILE_OWNER，播放器将加载每个备用插件，直到成功转换或没有其他插件可尝试。 如果找不到文件扩展名的转换插件，则 Player 不会显示警告消息。

Windows 媒体播放器 11 支持 ConvertPluginCLSID 注册表项。

文件扩展名注册表设置

Windows 媒体播放器转换插件