Commandes (API WPD)
L’application cliente et le pilote communiquent par le biais de commandes envoyées du client (via l’API appareil portable Windows) au pilote (via l’infrastructure de pilotes User-Mode). Une commande peut inclure ou non un paramètre et peut ou non retourner un résultat. Un client peut envoyer explicitement une commande en appelant la méthode IPortableDevice ::SendCommand ou la méthode IPortableDeviceService :SendCommand, ou implicitement, en appelant l’une des méthodes des interfaces clientes. Quelques commandes peuvent uniquement être envoyées explicitement ; ceux-ci sont notés dans la documentation de la commande. Les pages de référence de commande décrivent l’objectif d’une commande, ainsi que les paramètres qu’il attend de recevoir et quels paramètres il est censé retourner.
Une commande est identifiée par une structure PROPERTYKEY. Il s’agit de deux parties : une partie GUID (membre fmtid) et une partie DWORD (membre pid). La partie GUID est utilisée pour indiquer la catégorie à laquelle appartient la commande (les commandes associées appartiennent à la même catégorie et auront donc la même fmtid). La partie DWORD indique l’ID de commande et est utilisée pour distinguer les commandes individuelles d’une catégorie de commandes (les valeurs pid pour les commandes de la même catégorie seront différentes).
Le tableau suivant répertorie les catégories de commandes que les appareils portables Windows définissent. Les fabricants d’appareils peuvent définir leurs propres commandes en créant leurs propres catégories de commandes et id de commande. Toutefois, un fabricant ne doit pas ajouter de commandes aux catégories répertoriées ci-dessous, car celles-ci sont réservées par Microsoft.
catégories de commandes
Catégorie de commandes | Description |
---|---|
WPD_CATEGORY_COMMON | Commandes communes à tous les objets et appareils. |
WPD_CATEGORY_DEVICE_HINTS | Commandes utilisées pour récupérer des informations facultatives sur l’appareil qui peuvent être utilisées pour améliorer l’expérience de l’utilisateur final. |
WPD_CATEGORY_SMS | Commandes utilisées pour les appareils qui prennent en charge les fonctionnalités SMS (Short Message Service), qui sont généralement exposées sur les téléphones mobiles. |
WPD_CATEGORY_STILL_IMAGE_CAPTURE | Commandes utilisées pour les appareils qui prennent en charge la capture d’images. |
WPD_CATEGORY_STORAGE | Commandes utilisées pour les objets fonctionnels de stockage. |
Les commandes spécifiques définies pour chacun de ces types sont fournies dans les tableaux suivants, organisées par type de commande.
WPD_CATEGORY_COMMON catégorie
Commander | Description |
---|---|
WPD_COMMAND_COMMON_RESET_DEVICE | Réinitialise l’appareil. |
WPD_CATEGORY_DEVICE_HINTS catégorie
Commander | Description |
---|---|
WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION | Récupère les ID d’objet des dossiers qui peuvent contenir un objet d’un type spécifié. |
WPD_CATEGORY_STORAGE catégorie
Commander | Description |
---|---|
WPD_COMMAND_STORAGE_EJECT | Éjecte un support de stockage qui peut être éjecté à distance par le pilote. |
WPD_COMMAND_STORAGE_FORMAT | Met en forme un objet fonctionnel de stockage sur l’appareil. |
WPD_CATEGORY_SMS catégorie
Commander | Description |
---|---|
WPD_COMMAND_SMS_SEND | Lance l’envoi d’un sms par un objet fonctionnel SMS. |
WPD_CATEGORY_STILL_IMAGE_CAPTURE catégorie
Commander | Description |
---|---|
WPD_COMMAND_STILL_IMAGE_CAPTURE_INITIATE | Lance une capture d’image toujours par un objet fonctionnel d’image toujours. |
Rubriques connexes