MÉTHODE IMDSPDevice ::GetSerialNumber (mswmdm.h)
La méthode GetSerialNumber récupère le numéro de série qui identifie de manière unique l’appareil.
Syntaxe
HRESULT GetSerialNumber(
[out] PWMDMID pSerialNumber,
[in, out] BYTE [8] abMac
);
Paramètres
[out] pSerialNumber
Pointeur vers une structure WMDMID qui reçoit le numéro de série de l’appareil. Ce paramètre est inclus dans le code d’authentification du message de sortie.
[in, out] abMac
Tableau de huit octets contenant le code d’authentification de message pour les données de paramètre de cette méthode. (WMDM_MAC_LENGTH est défini comme 8.)
Valeur retournée
Cette méthode retourne un code HRESULT. Toutes les méthodes d’interface dans Windows Media Gestionnaire de périphériques peuvent retourner l’une des classes de codes d’erreur suivantes :
- Codes d’erreur COM standard
- Codes d’erreur Windows convertis en valeurs HRESULT
- Codes d’erreur Gestionnaire de périphériques Windows Media
Remarques
Tous les appareils multimédias ne prennent pas en charge les numéros de série. Pour déterminer si l’appareil prend en charge les numéros de série, case activée toujours le code de retour lors de l’appel de cette méthode. Si un périphérique multimédia prend en charge les numéros de série, le numéro de série de l’appareil multimédia est garanti comme unique.
Cette méthode est facultative. Lors du transfert de contenu protégé, Windows Media Gestionnaire de périphériques utilise IMDSPStorageGlobals ::GetSerialNumber. Pour plus d’informations, consultez Interfaces obligatoires et facultatives.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | mswmdm.h |
| Bibliothèque | Mssachlp.lib |