Inscription de l’appareil

[La fonctionnalité associée à cette page, sdk Windows Media Format 11, est une fonctionnalité héritée. Il a été remplacé par lecteur source et enregistreur récepteur. lecteur source et enregistreur récepteur ont été optimisés pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise lecteur source et enregistreur récepteur au lieu d'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.]

Le Kit de développement logiciel (SDK) Windows Media Format permet d’accéder à la base de données d’inscription d’appareil. Cette base de données est sécurisée sur l’ordinateur client et est utilisée pour inscrire des appareils qui prennent en charge windows Media DRM 10 pour les appareils réseau.

Lorsqu’un appareil est ajouté à un réseau auquel l’ordinateur client est connecté, l’appareil tente de contacter une application d’émetteur Windows Media DRM 10 pour les appareils réseau. Après avoir établi des communications, l’appareil envoie un message de demande d’inscription.

Votre application doit effectuer les étapes suivantes lorsqu’elle reçoit un message de demande d’inscription :

1. Analysez le message en appelant la méthode IWMDRMMessageParser ::P arseRegistrationReqMsg. Cette méthode récupère le certificat d’appareil et le numéro de série de l’appareil, dont les deux sont nécessaires pour identifier l’appareil.
2. Appelez la méthode IWMDeviceRegistration ::GetRegisteredDeviceByID, en passant le certificat et le numéro de série de l’appareil récupérés à l’étape 1. Si l’appareil est trouvé, il est déjà inscrit et vous pouvez ignorer l’étape suivante.
3. Appelez la méthode IWMDeviceRegistration ::RegisterDevice pour ajouter l’appareil à la base de données d’inscription de l’appareil.

Vous pouvez accéder à des informations sur n’importe quel appareil de la base de données d’inscription en récupérant l’objet d’appareil inscrit associé à celui-ci. Il existe deux façons d’obtenir un objet d’appareil inscrit. Si vous disposez du certificat et du numéro de série de l’appareil, vous pouvez appeler la méthode IWMDeviceRegistration ::GetRegisteredDeviceByID. Si vous n’avez pas le certificat et le numéro de série de l’appareil, vous pouvez énumérer tous les appareils de la base de données en appelant IWMDeviceRegistration ::GetFirstRegisteredDevice suivis d’appels répétés à IWMDeviceRegistration ::GetNextRegisteredDevice jusqu’à ce qu’un appel retourne S_FALSE.

Avant que votre application puisse envoyer des données à un appareil, vous devez vous assurer que l’appareil est approuvé, validé et ouvert.

L’approbation de l’appareil doit impliquer l’interaction avec l’utilisateur. Lorsqu’un appareil envoie un message d’inscription, votre application peut inviter l’utilisateur à décider si l’appareil est celui qui doit recevoir les données de cet utilisateur. Mettez ensuite à jour la base de données d’inscription d’appareil en appelant la méthode IWMRegisteredDevice ::Approve, en passant TRUE ou FALSE le cas échéant.

La validation est également appelée détection de proximité. Il s’agit d’un processus par lequel les objets DRM internes du Kit de développement logiciel (SDK) Windows Media Format déterminent si l’appareil est « proche » de l’ordinateur exécutant votre application pour transmettre en toute sécurité des médias. La proximité est déterminée par le temps nécessaire pour obtenir une réponse à un message. Cette fonctionnalité est destinée à empêcher les utilisateurs non autorisés d’accéder à votre réseau et d’obtenir votre média sécurisé. Pour plus d’informations, consultez Exécution de la détection de proximité.

Pour ouvrir un appareil, appelez IWMRegisteredDevice ::Open.

Rubriques connexes

IWMRegisteredDevice

à l’aide du protocole DRM 10 Windows Media pour les appareils réseau