Méthode IWMDRMDeviceApp::AcquireDeviceData

Article
06/13/2023

La méthode AcquireDeviceData initialise ou réinitialise une horloge sécurisée d’appareil.

Syntaxe

HRESULT AcquireDeviceData(
  [in]  IWMDMDevice    *pDevice,
  [in]  IWMDMProgress3 *pProgressCallback,
  [in]  DWORD          dwFlags,
  [out] DWORD          *pdwStatus
);

Paramètres

pDevice [in]

Pointeur vers une interface IWMDMDevice pour l’appareil qui signale les données de mesure.

pProgressCallback [in]

Rappel de progression par le biais duquel l’application peut suivre la progression de l’événement ou annuler l’événement. La progression est identifiée par le paramètre EventId des méthodes IWMDMProgress3 .

dwFlags [in]

OU logique d’un ou des deux indicateurs suivants, spécifiant l’action à effectuer. Cette valeur est récupérée à partir du paramètre pdwStatus de IWMDRMDeviceApp::QueryDeviceStatus ou IWMDRMDeviceApp2::QueryDeviceStatus2. Vous pouvez utiliser l’indicateur pdwStatus directement.

Indicateur	Description
WMDRM_DEVICE_NEEDCLOCK	Acquérir une horloge à partir d’un serveur d’horloge sécurisé.
WMDRM_DEVICE_REFRESHCLOCK	Actualisez l’horloge à partir d’un serveur d’horloge sécurisé.

pdwStatus [out]

L’une des valeurs DWORD suivantes spécifiant le status retourné par l’appareil.

Statut	Description
0	L’action n’est pas prise en charge.
1	L’horloge sécurisée de l’appareil n’a pas pu être acquise auprès du service.
2	Impossible de définir l’horloge sécurisée de l’appareil.
3	L’horloge sécurisée de l’appareil a été définie.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK
DRM_E_INVALIDARG	Un ou plusieurs arguments ne sont pas valides.
NS_E_DEVICE_NOT_WMDRM_DEVICE	L’appareil spécifié n’est pas un appareil compatible avec Windows Media DRM.
NS_E_DRM_UNABLE_TO_GET_SECURE_CLOCK	Échec de la récupération de la demande d’horloge sécurisée à partir de l’appareil ou impossible de récupérer l’URL de l’horloge sécurisée à partir du défi.
NS_E_DRM_UNABLE_TO_GET_SECURE_CLOCK_FROM_SERVER	Échec de la récupération de la réponse d’horloge sécurisée à partir du serveur d’horloge sécurisée.
NS_E_DRM_UNABLE_TO_SET_SECURE_CLOCK	Échec de l’envoi de la demande d’horloge sécurisée à l’appareil ou échec de la définition de l’horloge par l’appareil.

Notes

Il s’agit d’une méthode asynchrone ; L’appareil doit attendre le rappel IWMDMProgress::End pour cette opération avant de tenter de lire du contenu sous licence.

Une application peut savoir si son horloge doit être réinitialisée ou mise à jour en appelant IWMDRMDeviceApp::QueryDeviceStatus ou IWMDRMDeviceApp2::QueryDeviceStatus2.

Votre application doit disposer d’une connexion Internet pour lui permettre d’acquérir ou de réinitialiser une horloge sécurisée.

Spécifications

Condition requise	Valeur
En-tête	WMDRMDeviceApp.h (nécessite également Wmdrmdeviceapp_i.c, généré à partir de WMDRMDeviceApp.idl)
Bibliothèque	Mssachlp.lib

Voir aussi

Gestion du contenu protégé dans l’application
IWMDMDevice, interface
IWMDMProgress3, interface
IWMDRMDeviceApp, interface

Partager via