Objet Device
L’objet d’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 d’appareil ne doit pas être affiché à l’utilisateur. |
| WPD_OBJECT_REFERENCES | Obligatoire si l’objet d’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 la gestion des droits numériques (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 standard
Ces objets n’hébergent généralement pas de 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 commande qui s’appliquent aux appareils, par fonctionnalité. En règle générale, un appareil relève de plusieurs catégories et doit prendre en charge les commandes pour toutes les catégories applicables. Par exemple, un téléphone mobile équipé d’un appareil photo relève de trois catégories : tous les appareils, les appareils SMS et les appareils de capture d’images fixes. 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 appartiennent à 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 fixes, telles que des appareils photo numériques. | WPD_CATEGORY_STILL_IMAGE_CAPTURE |
| Les appareils qui peuvent envoyer des messages SMS (Short Message Service), tels que les téléphones cellulaires. L’envoi de SMS est souvent appelé « messagerie texte ». | WPD_CATEGORY_SMS |
| Appareils qui fonctionnent comme des périphériques 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 à un autre, votre pilote doit prendre en charge cette catégorie. |
WPD_CATEGORY_STORAGE |