Partilhar via


Registando dependência de aplicação (Windows Media Format 11 SDK)

[A funcionalidade associada a esta página, Windows Media Format 11 SDK, é uma funcionalidade herdada. Foi substituído por Source Reader e Sink Writer. Source Reader e Sink Writer foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda vivamente que o novo código utilize o Leitor de Origem e o Escritor de Destino em vez do SDK do Windows Media Format 11 , sempre que 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 do Windows Media Format ou pelo SDK do Windows Media Player dependem dos componentes de tempo de execução dessas tecnologias. Você pode registrar seu aplicativo como sendo 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 uma ou mais aplicações estão registadas com uma dependência de bloqueio de um dos componentes de tempo de execução, o componente será impedido de reverter para uma versão anterior. Aplicações dependentes que não estão registadas como bloqueadoras, não bloqueiam a reversão. Em vez disso, antes que a reversão seja executada, o usuário recebe uma mensagem informando que os aplicativos dependem do componente.

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

Os seguintes valores do Registro são usados para registrar a dependência do tempo de execução do SDK do Windows Media Format:

  • 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 do tempo de execução do SDK do Windows Media Player:

  • 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 dependência ou por DependentRefCounts para dependência sem bloqueio.

APP

Nome ou descritor curto do seu 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 de tempo de execução.

APP_STRING

Descritor da sua aplicação. 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 um máximo de 256 caracteres.

WMP_VERSION

Versão do Windows Media Player exigida pela sua aplicação.

WMF_VERSION

Versão do SDK do Windows Media Format exigida pelo seu aplicativo.

Os três exemplos de valores do Registro a seguir demonstram como configurar os valores para seu aplicativo:

  • HKEY_CLASSES_ROOT\Software\Microsoft\WindowsMedia\Setup\DependentRefCounts\App, "SouthridgeVideo", "Leitor de Vídeo Southridge"
  • HKEY_CLASSES_ROOT\Software\Microsoft\WindowsMedia\Setup\DependentRefCounts\Descriptor, "SouthridgeVideo", "Southridge Video Player usa o SDK do Windows Media Format para reproduzir arquivos de vídeo."
  • HKEY_CLASSES_ROOT\Software\Microsoft\WindowsMedia\Setup\DependentRefCounts\Version, "SouthridgeVideo", "9.0.0.2600"

Considerações do projeto