Partager via

Inscription d’une dépendance d’application (Sdk Windows Media Format 11)

  • Article

[La fonctionnalité associée à cette page, le Kit de développement logiciel (SDK) Windows Media Format 11, est une fonctionnalité héritée. Il a été remplacé par le lecteur source et l’enregistreurrécepteur. Le lecteur source et l’enregistreur récepteur ont été optimisés pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise le lecteur source et l’enregistreur récepteur au lieu du Kit de développement logiciel (SDK) Windows Media Format 11, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

Les applications qui utilisent des API fournies par le Kit de développement logiciel (SDK) au format Windows Media ou Lecteur multimédia Windows SDK dépendent des composants d’exécution de ces technologies. Vous pouvez inscrire votre application comme étant dépendante de ces composants dans le cadre de la configuration de votre application.

Lorsque vous inscrivez votre application, vous pouvez choisir l’un des deux niveaux de dépendance suivants : blocage ou dépendance. Lorsqu’une ou plusieurs applications sont inscrites avec une dépendance bloquante sur l’un des composants d’exécution, le composant est bloqué à partir d’une restauration vers une version précédente. Les applications dépendantes qui ne sont pas inscrites comme bloquantes ne bloquent pas la restauration. Au lieu de cela, avant l’exécution de la restauration, l’utilisateur est invité à envoyer un message indiquant que les applications dépendent du composant.

Pour inscrire votre application, vous devez définir une valeur dans le Registre qui identifie votre application. La valeur de Registre à définir dépend du composant dont dépend votre application. Vous pouvez également définir deux valeurs supplémentaires par dépendance pour fournir des informations supplémentaires sur votre application.

Les valeurs de Registre suivantes sont utilisées pour inscrire la dépendance vis-à-vis du runtime du KIT de développement logiciel (SDK) au format 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 »

La valeur de Registre suivante est utilisée pour inscrire la dépendance vis-à-vis de Lecteur multimédia Windows runtime du SDK :

  • 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 »

Les variables suivantes sont utilisées dans les valeurs de Registre répertoriées ci-dessus :

REF_TYPE

Remplacez par BlockingRefCounts pour bloquer la dépendance, ou par DependentRefCounts pour la dépendance non bloquante.

APP

Nom ou descripteur court de votre application. Cette chaîne ne sera pas utilisée dans les messages affichés pour l’utilisateur. Cette valeur est l’identificateur utilisé dans les trois valeurs de Registre associées à chacun des composants d’exécution.

APP_STRING

Descripteur de votre application. Cette chaîne peut être utilisée dans les messages affichés pour l’utilisateur.

REF_DESCRIPTOR

Description de la façon dont votre application utilise le composant. Cette valeur peut inclure un maximum de 256 caractères.

WMP_VERSION

Version de Lecteur multimédia Windows requise par votre application.

WMF_VERSION

Version du Kit de développement logiciel (SDK) au format Windows Media requise par votre application.

Les trois exemples de valeurs de Registre suivants montrent comment configurer les valeurs de votre application :

  • 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 utilise le Kit de développement logiciel (SDK) au format Windows Media pour lire des fichiers vidéo ».
  • HKEY_CLASSES_ROOT\Software\Microsoft\WindowsMedia\Setup\DependentRefCounts\Version, « SouthridgeVideo », « 9.0.0.2600 »

Considérations relatives au projet