IWMDRMDeviceApp2 :: QueryDeviceStatus2, méthode
La méthode QueryDeviceStatus2 interroge un appareil pour obtenir un État ou une fonctionnalité DRM spécifique.
Syntaxe
HRESULT QueryDeviceStatus2(
[in] IWMDMDevice *pDevice,
[in] DWORD dwFlags,
[out] DWORD *pdwStatus
);
Paramètres
-
pDevice [ dans]
-
Pointeur vers un objet IWMDMDevice .
-
dwFlags [ dans]
-
Une ou plusieurs des valeurs DWORD suivantes spécifiant les fonctionnalités à demander, combinées avec une opération or au niveau du bit.
Indicateur Description _INDIVSTATUS du _ client de requête WMDRM _ Demander si les composants DRM de l’ordinateur doivent être individualisés. CLOCKSTATUS de l' _ appareil de requête WMDRM _ _ Demander si l’horloge sécurisée de l’appareil doit être ajoutée ou mise à jour. ISREVOKED de l' _ appareil de requête WMDRM _ _ Demander si l’appareil est révoqué. ISWMDRM de l' _ appareil de requête WMDRM _ _ demander si l’appareil prend en charge Windows Media DRM 10 pour les appareils mobiles. -
pdwStatus [ à]
-
Zéro, une ou plusieurs des valeurs DWORD suivantes spécifiant l’état de l’appareil demandé, combiné avec une opération or au niveau du bit.
Statut Description _ISWMDRM d’appareil WMDRM _ l’appareil prend en charge Windows DRM Media. _NEEDCLOCK d’appareil WMDRM _ L’appareil n’a pas d’horloge sécurisée. _appareil WMDRM _ révoqué L’appareil a été révoqué. _NEEDINDIV du client WMDRM _ Les composants DRM de l’ordinateur doivent être individualisés. _REFRESHCLOCK d’appareil WMDRM _ L’horloge doit être actualisée.
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. |
|
Le certificat d’appareil récupéré à partir de l’appareil n’est pas valide. |
|
Impossible de récupérer le certificat de l’appareil à partir de l’appareil. |
Remarques
Cette méthode doit être appelée avant d’effectuer des actions restreintes sur du contenu DRM, telles que le transfert de contenu DRM sur l’appareil ou l’obtention d’informations de contrôle. Si les valeurs récupérées par pdwStatus indiquent qu’une action doit être exécutée (par exemple, une individualisation pour le bureau ou l’acquisition d’une horloge pour l’appareil), l’application doit appeler IWMDRMDeviceApp :: AcquireDeviceData et transmettre la valeur pdwStatus Récupérée de cette fonction au paramètre dwFlags dans AcquireDeviceData. si la valeur zéro est retournée, l’appareil ne prend pas en charge Windows Media DRM 10 pour les appareils mobiles et aucune action n’est nécessaire. Pour plus d’informations, consultez gestion du contenu protégé dans l’application .
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|