Exécution de la détection de proximité
[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.]
Avant de pouvoir diffuser en continu des données chiffrées vers un appareil inscrit dans le protocole Windows Media DRM 10 for Network Devices, vous devez effectuer un processus appelé détection de proximité (également appelé validation). Ce processus implique l’envoi de messages à l’appareil et la réception de réponses. Le temps nécessaire pour recevoir une réponse est utilisé pour déterminer si l’appareil est suffisamment proche de l’ordinateur sur le réseau pour recevoir des données sécurisées. La confirmation que l’appareil est physiquement proche de l’ordinateur client sur le réseau permet d’empêcher l’usurpation et tout autre accès non autorisé.
Une fois la détection de proximité terminée, l’appareil est considéré comme valide. Vous pouvez case activée si un appareil est valide en appelant la méthode IWMRegisteredDevice::IsValid. Les appareils doivent être validés toutes les 48 heures. Un appareil qui a été validé plus de 48 heures avant l’exécution de votre programme doit être revalidé en effectuant à nouveau le processus de détection de proximité.
Pour effectuer la détection de proximité, vous devez établir des communications avec l’appareil, puis appeler la méthode IWMProximityDetection::StartDetection . Le processus de détection est effectué de manière asynchrone par les composants DRM internes du Kit de développement logiciel (SDK) au format Windows Media. Votre application doit inclure une implémentation de l’interface IWMStatusCallback pour traiter les messages de détection de proximité.
Deux messages sont envoyés par le processus de détection de proximité : un message de résultat et un message d’achèvement.
Le message de résultat, WMT_PROXIMITY_RESULT, est envoyé lorsque le processus de détection est terminé. Le paramètre hr de la méthode de rappel OnStatus indique si l’appareil est suffisamment proche de l’ordinateur client. Si le paramètre hr du message de résultat indique la réussite, le paramètre pValue contient un DWORD spécifiant la latence mesurée sur l’appareil en millisecondes.
Le message d’achèvement, WMT_PROXIMITY_COMPLETED, est envoyé lorsque la détection est finalisée. Vous devez libérer l’interface IWMProximityDetection uniquement après avoir reçu ce message.
Lorsque la détection de proximité d’un appareil réussit, la base de données d’inscription des appareils est automatiquement mise à jour. Les appels suivants à IWMRegisteredDevice::IsValid retournent TRUE jusqu’à ce que 48 heures se soient écoulées et que l’appareil doit être revalidé.
Note La gestion des droits numériques n’est pas prise en charge par la version x64 de ce Kit de développement logiciel (SDK).