Subchave ConvertPluginCLSID

  • Artigo

[O recurso associado a esta página, Reprodutor Multimídia do Windows SDK, é um recurso herdado. Foi substituído pelo MediaPlayer. O MediaPlayer foi otimizado para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o MediaPlayer em vez de Reprodutor Multimídia do Windows SDK, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

Quando Reprodutor Multimídia do Windows 11 encontra uma extensão de nome de arquivo personalizado, ela procura uma subchave do Registro que corresponda à extensão. A subchave é descrita em Configurações do Registro de Extensão de Nome de Arquivo. Em alguns casos, a subchave da extensão tem uma subchave chamada ConvertPluginCLSID.

Por exemplo, suponha que você tenha criado um formato de arquivo personalizado (com a extensão de nome de arquivo .xyz) e um plug-in de conversão que converte os arquivos em um formato compatível com Reprodutor Multimídia do Windows Em seguida, você armazenaria a ID de classe do plug-in em uma ou ambas as subchaves a seguir.

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

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

A subchave ConvertPluginCLSID especifica as IDs de classe de plug-ins que Reprodutor Multimídia do Windows podem usar para converter um arquivo de mídia de seu formato personalizado em um formato compatível com o Player.

A subchave ConvertPluginCLSID tem as entradas a seguir.

  • Uma entrada padrão que representa o plug-in de conversão padrão.
  • Uma entrada nomeada que representa o plug-in de conversão padrão.
  • Entradas nomeadas adicionais que representam plug-ins de conversão alternativos.

Por exemplo, suponha que um formato de arquivo personalizado tenha um plug-in de conversão padrão e dois plug-ins de conversão alternativos. As entradas do Registro na subchave ConvertPluginCLSID teriam o formulário a seguir.

Nome Type Valor
Padrão REG_SZ A ID da classe, no formato do Registro, do plug-in de conversão padrão.
A ID da classe, no formato do Registro, do plug-in de conversão padrão. REG_SZ O nome amigável do plug-in de conversão padrão.
A ID da classe, no formato de registro, do primeiro plug-in de conversão alternativa. REG_SZ O nome amigável do primeiro plug-in de conversão alternativa.
A ID da classe, no formato do Registro, do segundo plug-in de conversão alternativa. REG_SZ O nome amigável do segundo plug-in de conversão alternativa.

 

Observe que o plug-in de conversão padrão é representado por duas entradas do Registro: a entrada padrão e uma entrada nomeada. Reprodutor Multimídia do Windows usa a entrada padrão para determinar qual plug-in é o plug-in de conversão padrão (primário). Reprodutor Multimídia do Windows usa as entradas nomeadas para obter nomes amigáveis para todos os plug-ins de conversão, incluindo o plug-in padrão.

O nome amigável de um plug-in de conversão é determinado pela empresa que cria o plug-in. Reprodutor Multimídia do Windows pode exibir o nome amigável em sua interface do usuário.

Quando Reprodutor Multimídia do Windows tenta converter um arquivo de um formato personalizado para um formato padrão, ele primeiro carrega o plug-in padrão. Se o plug-in padrão não conseguir converter o arquivo e retornar NS_E_WMP_CONVERT_PLUGIN_UNKNOWN_FILE_OWNER, o Player carregará cada plug-in alternativo até que ocorra uma conversão bem-sucedida ou que não haja mais plug-ins para experimentar. O Player não exibirá uma mensagem de aviso se nenhum plug-in de conversão for encontrado para a extensão de nome de arquivo.

A entrada do registro ConvertPluginCLSID é compatível com Reprodutor Multimídia do Windows 11.

Configurações do Registro de Extensão de Nome de Arquivo

Plug-ins de conversão de Reprodutor Multimídia do Windows