Propriétés de l’appareil (PortableDevice.h)
Les appareils portables Windows prennent en charge les propriétés d’appareil suivantes.
| Propriété | VarType | Description |
|---|---|---|
| WPD_DEVICE_DATETIME | VT_DATE | Date et heure actuelles sur l’appareil. |
| WPD_DEVICE_FIRMWARE_VERSION | VT_LPWSTR | Version du microprogramme de l’appareil. |
| WPD_DEVICE_FUNCTIONAL_UNIQUE_ID | VT_VECTOR | VT_UI1 | Identificateur unique de 16 octets commun à plusieurs transports pris en charge par l’appareil. Si un seul appareil prend en charge plusieurs transports, cette propriété peut être utilisée pour associer les différents pilotes WPD de transport à cet appareil. |
| WPD_DEVICE_MANUFACTURER | VT_LPWSTR | Nom du fabricant de l’appareil lisible par l’utilisateur. |
| WPD_DEVICE_MODEL | VT_LPWSTR | Modèle de l'appareil. |
| WPD_DEVICE_MODEL_UNIQUE_ID | VT_VECTOR | VT_UI1 | Identificateur unique de 16 octets utilisé pour différencier les différents modèles d’un appareil. |
| WPD_DEVICE_NETWORK_IDENTIFIER | VT_UI8 | Valeur qui spécifie l’identificateur réseau EUI-64 de l’appareil ; cette propriété est utilisée pour les opérations réseau hors bande. Si l’appareil a des adresses réseau physiques MAC-48 (typique des réseaux IPv4), l’adresse MAC-48 est encodée dans l’adresse EUI-64 en tant que deux moitiés de l’adresse MAC-48 séparées par FF-FF. La valeur EUI-64 est stockée dans l’ordre « réseau » ou « big-endian », où une adresse EUI-64 de 01-02-03-FF-FF-04-05-06 serait placée dans le VT_UI8 de sorte que la valeur décimale soit 72624942021346566. Cette propriété est requise sur tout appareil qui prend en charge l’authentification nominale ou sécurisée. Cette propriété est recommandée sur les appareils qui prennent uniquement en charge l’authentification zéro. La valeur peut être utilisée par l’hôte pour établir automatiquement l’accès à l’appareil sans intervention de l’utilisateur. |
| WPD_DEVICE_POWER_LEVEL | VT_UI4 | Valeur comprise entre 0 et 100 qui spécifie le niveau d’alimentation de la batterie de l’appareil, 0 étant aucun et 100 étant entièrement chargé. |
| WPD_DEVICE_POWER_SOURCE | VT_UI4 | Énumération WPD_POWER_SOURCES qui spécifie la source d’alimentation de l’appareil. |
| WPD_DEVICE_PROTOCOL | VT_LPWSTR | Protocole d’appareil utilisé. |
| WPD_DEVICE_SERIAL_NUMBER | VT_LPWSTR | Numéro de série de l’appareil. |
| WPD_DEVICE_SUPPORTED_DRM_SCHEMES | VT_UNKNOWN | Valeur qui spécifie si les formats pris en charge retournés par l’appareil sont dans un ordre préféré. Le premier format de la liste est préféré par l’appareil, tandis que le dernier est le moins préféré. Les applications peuvent utiliser cette propriété pour déterminer si les formats pris en charge d’un appareil sont répertoriés dans un ordre par défaut. |
| WPD_DEVICE_SUPPORTED_FORMATS_ARE_ORDERED | VT_BOOL | Valeur booléenne qui spécifie si les formats pris en charge retournés par l’appareil sont dans un ordre préféré ; autrement dit, le premier format retourné est préféré, tandis que le dernier format retourné est le moins recommandé. |
| WPD_DEVICE_SUPPORTS_NON_CONSUMABLE | VT_BOOL | Valeur booléenne qui spécifie si l’appareil prend en charge les objets non consommables. Il s’agit d’objets que l’appareil est uniquement destiné à stocker, et non à jouer ou à utiliser de quelque manière que ce soit. |
| WPD_DEVICE_SYNC_PARTNER | VT_LPWSTR | Description lisible du partenaire de synchronisation d’un appareil. Il s’agit d’un appareil, d’une application ou d’un serveur avec lequel l’appareil communique pour conserver un état commun ou un groupe de fichiers entre les deux partenaires. Les programmes de messagerie et les bibliothèques de musique en sont des exemples. |
| WPD_DEVICE_FRIENDLY_NAME | VT_LPWSTR | Valeur qui représente le nom convivial défini par l’utilisateur sur l’appareil. |
| WPD_DEVICE_TRANSPORT | VT_UI4 | transport pris en charge par l’appareil, par exemple USB, IP ou Bluetooth. Les valeurs valides sont du type d’énumération WPD_DEVICE_TRANSPORTS . |
| WPD_DEVICE_TYPE | VT_UI4 | Valeur qui spécifie le type d’appareil ; les applications utilisent cette propriété à des fins de représentation uniquement. Les caractéristiques fonctionnelles de l’appareil sont déterminées par le biais d’objets fonctionnels. Les appareils qui ne fournissent pas d’icône d’appareil, par exemple un WPD_RESOURCE_ICON pour l’objet d’appareil, sont représentés dans l’espace de noms WPD avec une icône générique. Cette icône dépend du type d’appareil spécifié, par exemple, si le type d’appareil est un téléphone mobile, l’icône de téléphone générique est utilisée. Lors de la première installation de l’appareil, le programme d’installation de classe WPD interroge cette valeur de propriété et la stocke dans le registre d’appareils sous la valeur PORTABLE_DEVICE_TYPE en tant que REG_DWORD. Les valeurs possibles de ce paramètre proviennent de l’énumération WPD_DEVICE_TYPES définie dans PortableDevice.h. Les valeurs sont les suivantes :
WPD_DEVICE_TYPE_CAMERA WPD_DEVICE_TYPE_MEDIA_PLAYER WPD_DEVICE_TYPE_PHONE WPD_DEVICE_TYPE_VIDEO WPD_DEVICE_TYPE_PERSONAL_INFORMATION_MANAGER WPD_DEVICE_TYPE_AUDIO_RECORDER |
| WPD_DEVICE_USE_DEVICE_STAGE | VT_BOOL | Si cette propriété existe et est définie sur TRUE, l’appareil peut être utilisé avec Device Stage . Cela est destiné aux appareils qui ne peuvent pas stocker de métadonnées à l’aide du service de métadonnées d’appareil, mais qui fournissent des métadonnées sur les serveurs Microsoft. |
Spécifications
| Condition requise | Valeur |
|---|---|
| En-tête |
|