Propriétés de l’appareil (PortableDevice. h)
Windows Les appareils mobiles 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 qui est commun entre 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 de 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 faire la distinction entre 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 possède des adresses réseau physiques MAC-48 (en général des réseaux IPv4), l’adresse MAC-48 est encodée dans l’adresse EUI-64, car les deux moitiés de l’adresse MAC-48 sont séparées par FF-FF. La valeur EUI-64 est stockée " dans " " un 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 manière à ce que la valeur décimale soit 72624942021346566. Cette propriété est requise sur tous les appareils qui prennent 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 de puissance de la batterie de l’appareil, 0 étant aucun et 100 entièrement facturé. |
| 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 de préférence. Le premier format de la liste est préféré par l’appareil, tandis que le dernier est le moins recommandé. Les applications peuvent utiliser cette propriété pour déterminer si les formats pris en charge par un appareil sont répertoriés dans un ordre de préférence. |
| 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 de préférence. autrement dit, le premier format retourné est plus 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 destiné uniquement à stocker, à ne pas lire ou à utiliser de quelque manière que ce soit. |
| WPD_DEVICE_SYNC_PARTNER | VT_LPWSTR | Description explicite du partenaire de synchronisationd’un appareil. Il s’agit d’un périphérique, d’une application ou d’un serveur avec lequel l’appareil communique pour maintenir un État commun ou un groupe de fichiers entre les deux partenaires. Les programmes de messagerie électronique et les bibliothèques musicales 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, tel que 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 choisies par le biais d’objets fonctionnels. Les appareils qui ne fournissent pas d’icône d’appareil, par exemple, une WPD_RESOURCE_ICON pour l’objet 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 de périphérique 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 la classe WPD interroge cette valeur de propriété et le stocke dans le registre de l’appareil 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 qu’elle a la valeur true, l’appareil peut être utilisé avec l’étape de l’appareil. Cela est destiné aux appareils qui ne peuvent pas stocker les métadonnées à l’aide de l' Metadata service d’appareil, mais qui fournissent des métadonnées sur les serveurs Microsoft. |
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête |
|