Partager via

Commandes (API WPD)

  • Article

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.

 

de référence de programmation