IWMDRMDeviceApp :: AcquireDeviceData, méthode
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 [ dans]
-
Pointeur vers une interface IWMDMDevice pour l’appareil qui signale les données de contrôle.
-
pProgressCallback [ dans]
-
Rappel de progression via lequel 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 [ dans]
-
Or logique de l’un des indicateurs suivants, en spécifiant l’action à effectuer. Cette valeur est extraite du paramètre pdwStatus de IWMDRMDeviceApp :: QueryDeviceStatus ou IWMDRMDeviceApp2 :: QueryDeviceStatus2. Vous pouvez utiliser l’indicateur pdwStatus directement.
Indicateur Description _NEEDCLOCK d’appareil WMDRM _ Acquérir une horloge à partir d’un serveur d’horloge sécurisé. _REFRESHCLOCK d’appareil WMDRM _ Actualisez l’horloge à partir d’un serveur d’horloge sécurisé. -
pdwStatus [ à]
-
Une des valeurs DWORD suivantes spécifiant l’état retourné par l’appareil.
État 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 L’horloge sécurisée de l’appareil n’a pas pu être définie. 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 |
|
Un ou plusieurs arguments ne sont pas valides. |
|
l’appareil spécifié n’est pas un appareil compatible avec DRM Windows Media. |
|
Impossible de récupérer le challenge d’horloge sécurisée à partir de l’appareil ou de récupérer l’URL d’horloge sécurisée à partir de la demande. |
|
Échec de la récupération de la réponse d’horloge sécurisée à partir du serveur d’horloge sécurisé. |
|
Impossible d’envoyer le challenge d’horloge sécurisée à l’appareil, ou l’appareil n’a pas pu définir l’horloge. |
Remarques
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 un contenu sous licence.
Une application peut déterminer si l’horloge de l’appareil 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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|