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_GENERIC
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
PortableDevice. h

Voir aussi

Propriétés et attributs WPD