Registrando a dependência do aplicativo (SDK do Windows Media Format 11)

  • Artigo

[O recurso associado a esta página, Windows Media Format 11 SDK, é um recurso herdado. Ele foi substituído por Leitor de Origem e Gravador de Coletor. O Leitor de Origem e o Gravador de Coletor foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o Leitor de Origem e o Gravador de Coletor em vez do SDK do Windows Media Format 11, 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.]

Os aplicativos que usam APIs fornecidas pelo SDK de Formato de Mídia do Windows ou Reprodutor Multimídia do Windows SDK dependem dos componentes de tempo de execução dessas tecnologias. Você pode registrar seu aplicativo como dependente desses componentes como parte da configuração do aplicativo.

Ao registrar seu aplicativo, você pode escolher um dos dois níveis de dependência: bloqueio ou dependente. Quando um ou mais aplicativos são registrados com uma dependência de bloqueio em um dos componentes em tempo de execução, o componente será bloqueado de uma reversão para uma versão anterior. Aplicativos dependentes que não estão registrados como bloqueio não bloqueiam a reversão. Em vez disso, antes que a reversão seja executada, o usuário é solicitado com uma mensagem informando que os aplicativos dependem do componente.

Para registrar seu aplicativo, você deve definir um valor no Registro que identifique seu aplicativo. O valor do Registro a ser definido depende do componente no qual seu aplicativo depende. Você também pode definir dois valores adicionais por dependência para fornecer informações extras sobre seu aplicativo.

Os seguintes valores do Registro são usados para registrar a dependência do runtime do SDK de Formato de Mídia do Windows:

  • HKEY_CLASSES_ROOT\Software\Microsoft\WindowsMedia\Setup\REF_TYPE\App, "APP", "APP_STRING"
  • HKEY_CLASSES_ROOT\Software\Microsoft\WindowsMedia\Setup\REF_TYPE\Descritor, "APP", "REF_DESCRIPTOR"
  • HKEY_CLASSES_ROOT\Software\Microsoft\WindowsMedia\Setup\REF_TYPE\Version, "APP", "WMF_VERSION"

O seguinte valor do Registro é usado para registrar a dependência de Reprodutor Multimídia do Windows runtime do SDK:

  • HKEY_CLASSES_ROOT\Software\Microsoft\MediaPlayer\Setup\REF_TYPE\App, "APP", "APP_STRING"
  • HKEY_CLASSES_ROOT\Software\Microsoft\MediaPlayer\Setup\REF_TYPE\Descritor, "APP", "REF_DESCRIPTOR"
  • HKEY_CLASSES_ROOT\Software\Microsoft\MediaPlayer\Setup\REF_TYPE\Version, "APP", "WMP_VERSION"

As seguintes variáveis são usadas nos valores do Registro listados acima:

REF_TYPE

Substitua por BlockingRefCounts para bloquear a dependência ou por DependentRefCounts para dependência sem bloqueio.

APP

Nome ou descritor curto do aplicativo. Essa cadeia de caracteres não será usada em mensagens exibidas para o usuário. Esse valor é o identificador usado em todos os três valores do Registro associados a cada um dos componentes em tempo de execução.

APP_STRING

Descritor do aplicativo. Essa cadeia de caracteres pode ser usada em mensagens exibidas para o usuário.

REF_DESCRIPTOR

Descrição de como seu aplicativo usa o componente . Esse valor pode incluir no máximo 256 caracteres.

WMP_VERSION

A versão de Reprodutor Multimídia do Windows exigida pelo aplicativo.

WMF_VERSION

Versão do SDK de Formato de Mídia do Windows exigida pelo aplicativo.

Os três valores de registro de exemplo a seguir demonstram como configurar os valores para seu aplicativo:

  • HKEY_CLASSES_ROOT\Software\Microsoft\WindowsMedia\Setup\DependentRefCounts\App, "SouthridgeVideo", "Southridge Video Player"
  • HKEY_CLASSES_ROOT\Software\Microsoft\WindowsMedia\Setup\DependentRefCounts\Descriptor, "SouthridgeVideo", "O Southridge Video Player usa o SDK do Formato de Mídia do Windows para reproduzir arquivos de vídeo".
  • HKEY_CLASSES_ROOT\Software\Microsoft\WindowsMedia\Setup\DependentRefCounts\Version, "SouthridgeVideo", "9.0.0.2600"

Considerações sobre o projeto