Partager via

Device, objet

L’objet appareil prend en charge les propriétés suivantes. Une application peut demander ces propriétés en interrogeant l’objet racine (en spécifiant l’ID d’objet constant WPD_DEVICE_OBJECT_ID défini). Toutes les valeurs de l’objet d’appareil sont en lecture seule.

Si un appareil donné implémente la catégorie WPD_FUNCTIONAL_CATEGORY_DEVICE, il doit également prendre en charge les propriétés associées à cette catégorie.

Nom de la propriété Obligatoire ou facultatif
WPD_OBJECT_ID Obligatoire. La valeur est WPD_DEVICE_OBJECT_ID.
WPD_OBJECT_PARENT_ID Obligatoire. La valeur est une chaîne vide.
WPD_OBJECT_NAME Obligatoire si l’objet représente un fichier.
WPD_OBJECT_PERSISTENT_UNIQUE_ID Obligatoire.
WPD_OBJECT_ISHIDDEN Obligatoire si l’objet de l’appareil ne doit pas être affiché à l’utilisateur.
WPD_OBJECT_REFERENCES Obligatoire si l’objet de l’appareil a des références à d’autres objets.
WPD_OBJECT_KEYWORDS Optionnel.
WPD_OBJECT_SYNC_ID Optionnel.
WPD_OBJECT_GENERATE_THUMBNAIL_FROM_RESOURCE Optionnel.
WPD_DEVICE_SYNC_PARTNER Optionnel.
WPD_DEVICE_FIRMWARE_VERSION Obligatoire.
WPD_DEVICE_POWER_LEVEL Recommandé si l’appareil a une batterie.
WPD_DEVICE_POWER_SOURCE Recommandé.
WPD_DEVICE_PROTOCOL Recommandé.
WPD_DEVICE_MANUFACTURER Obligatoire.
WPD_DEVICE_MODEL Obligatoire.
WPD_DEVICE_SERIAL_NUMBER Obligatoire.
WPD_DEVICE_SUPPORTS_NON_CONSUMABLE Obligatoire si l’appareil prend en charge les objets non consommables ; autrement dit, s’il peut être utilisé pour le stockage de données simple.
WPD_DEVICE_DATETIME Optionnel.
WPD_DEVICE_FRIENDLY_NAME Recommandé.
WPD_DEVICE_SUPPORTED_DRM_SCHEME Recommandé si l’appareil prend en charge Digital Rights Management (DRM).
WPD_DEVICE_SUPPORTED_FORMATS_ARE_ORDERED Recommandé si l’appareil prend en charge l’ordre de format préféré.
WPD_DEVICE_TYPE Recommandé.
WPD_DEVICE_FUNCTIONAL_UNIQUE_ID Optionnel.
WPD_DEVICE_MODEL_UNIQUE_ID Optionnel.
WPD_DEVICE_TRANSPORT Recommandé.
WPD_DEVICE_USE_DEVICE_STAGE Optionnel.
WPD_FUNCTIONAL_OBJECT_CATEGORY Obligatoire.

Ressources classiques

Ces objets n’hébergent généralement pas les ressources.

Commandes

En plus des propriétés, les appareils doivent prendre en charge un ensemble spécifique de commandes définies par les appareils portables Windows. Les commandes prises en charge par un objet ou un appareil dépendent de son type, de ses fonctionnalités et de ses fonctionnalités.

Le tableau suivant décrit les classes de commandes qui s’appliquent aux appareils, par fonctionnalité. En règle générale, un appareil se trouve sous plusieurs catégories et doit prendre en charge les commandes pour toutes les catégories applicables. Par exemple, un téléphone mobile doté d’une caméra se trouve sous trois catégories : tous les appareils, appareils SMS et appareils de capture d’images. Un pilote personnalisé et une application cliente peuvent prendre en charge des commandes ou des propriétés supplémentaires que vous définissez, mais doivent prendre en charge les commandes suivantes. Pour obtenir une description des commandes spécifiques qui se trouvent sous chaque catégorie de commandes, consultez Commandes.

Description Catégories de commandes
Tous les appareils. WPD_CATEGORY_CAPABILITIESWPD_CATEGORY_COMMON
WPD_CATEGORY_OBJECT_ENUMERATION
WPD_CATEGORY_OBJECT_MANAGEMENT
WPD_CATEGORY_OBJECT_PROPERTIES
WPD_CATEGORY_OBJECT_PROPERTIES_BULK
WPD_CATEGORY_OBJECT_RESOURCES
Appareils qui peuvent capturer des images toujours, telles que des caméras numériques. WPD_CATEGORY_STILL_IMAGE_CAPTURE
Appareils qui peuvent envoyer des messages sms (short message service), tels que des téléphones cellulaires. L’envoi de sms est souvent appelé « messagerie texte ». WPD_CATEGORY_SMS
Appareils qui fonctionnent en tant qu’appareils de stockage. Il s’agit notamment de lecteurs externes. Si un appareil prend en charge la possibilité de mettre en forme un magasin ou de déplacer des objets d’un emplacement vers un autre, votre pilote doit prendre en charge cette catégorie.
 WPD_CATEGORY_STORAGE

Configuration requise pour les objets

  • Last updated on