Регистрация зависимостей приложений (пакет SDK для Формата Windows Media 11)

[Функция, связанная с этой страницей, Windows Media Format 11 SDK, является устаревшей функцией. Его заменили средство чтения источника и устройство записи приемника . модуль чтения источника и модуль записи приемника оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать новый код с интерфейсом Source Reader и интерфейсом Sink Writer, вместо пакета Windows Media Format 11 SDK, если это возможно. Корпорация Майкрософт предлагает, что существующий код, использующий устаревшие API, будет перезаписан для использования новых API, если это возможно.]

Приложения, использующие API, предоставляемые пакетом SDK для формата Windows Media или пакетом SDK проигрывателя Windows Media, зависят от компонентов времени выполнения этих технологий. Вы можете зарегистрировать приложение в зависимости от этих компонентов в рамках настройки приложения.

При регистрации приложения можно выбрать один из двух уровней зависимости: блокировку или зависимость. При регистрации одного или нескольких приложений с блокирующей зависимостью от одного из компонентов времени выполнения компонент будет заблокирован от отката к предыдущей версии. Зависимые приложения, которые не зарегистрированы как блокирующие, не препятствуют откату. Вместо этого перед выполнением отката пользователю предлагается сообщение о том, что приложения зависят от компонента.

Чтобы зарегистрировать приложение, необходимо задать значение в реестре, которое идентифицирует приложение. Заданное значение реестра зависит от компонента, от которого зависит ваше приложение. Можно также задать два дополнительных значения для каждой зависимости, чтобы предоставить дополнительные сведения о приложении.

Следующие значения реестра используются для регистрации зависимости от среды выполнения пакета SDK для формата Windows Media:

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

Следующее значение реестра используется для регистрации зависимости от среды выполнения пакета SDK проигрывателя Windows Media:

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

Следующие переменные используются в значениях реестра, перечисленных выше:

REF_TYPE

Замените на BlockingRefCounts для блокирующей зависимости или DependentRefCounts для неблокирующей зависимости.

APP

Имя или короткий дескриптор приложения. Эта строка не будет использоваться в сообщениях, отображаемых для пользователя. Это значение является идентификатором, используемым во всех трех значениях реестра, связанных с каждым из компонентов времени выполнения.

APP_STRING

Дескриптор приложения. Эта строка может использоваться в сообщениях, отображаемых для пользователя.

REF_DESCRIPTOR

Описание того, как приложение использует компонент. Это значение может содержать не более 256 символов.

WMP_VERSION

Версия проигрывателя Windows Media, требуемая приложением.

WMF_VERSION

Версия пакета SDK для формата Windows Media, необходимая для приложения.

В следующем трех примерах значений реестра показано, как настроить значения для приложения:

  • HKEY_CLASSES_ROOT\Software\Microsoft\WindowsMedia\Setup\DependentRefCounts\App, SouthridgeVideo, "Southridge Video Player"
  • HKEY_CLASSES_ROOT\Software\Microsoft\WindowsMedia\Setup\DependentRefCounts\Descriptor, SouthridgeVideo, "Southridge Video Player использует пакет SDK для формата Windows Media для воспроизведения видеофайлов".
  • HKEY_CLASSES_ROOT\Software\Microsoft\WindowsMedia\Setup\DependentRefCounts\Version, "SouthridgeVideo", "9.0.0.2600"

Вопросы проектирования