Comment spécifier les fonctionnalités de l’appareil pour HIDHow to specify device capabilities for HID

Remarque  pour Windows 10, consultez Nouveautés de Windows 10.Note  For Windows 10, see What's different in Windows 10.

 

Le manifeste du package est un document XML qui contient les informations dont le système a besoin pour déployer, afficher ou mettre à jour une application Windows Runtime.The package manifest is an XML document that contains the info the system needs to deploy, display, or update a Windows Runtime app. Ces informations comprennent l’identité du package, les dépendances du package, les fonctionnalités nécessaires, les éléments visuels et les points d’extensibilité.This info includes package identity, package dependencies, required capabilities, visual elements, and extensibility points. Chaque package d’application doit inclure un manifeste de package.Every app package must include one package manifest.

Une application Windows Runtime qui accède à un périphérique HID doit inclure des données DeviceCapability spécifiques dans le nœud fonctionnalités de son manifeste.A Windows Runtime app that accesses a HID device must include specific DeviceCapability data in the Capabilities node of its manifest. Ces données identifient l’appareil et son objectif (ou fonction).This data identifies the device and its purpose (or function). Notez que certains appareils peuvent avoir plusieurs fonctions.Note that some devices may have multiple functions.

L’élément ID de l' appareil correspond à l’identificateur de l’appareil.The Device Id element corresponds to the device identifier. Cet élément peut spécifier une combinaison d’un ID de fournisseur (vid) et d’un ID de produit (PID); elle peut également spécifier une chaîne générique (« any »).This element may specify a combination Vendor Id (vid) and Product Id (pid); or, it may specify a generic string ("any"). En outre, l' ID d’appareil peut contenir une chaîne de fournisseur facultative « USB » ou « Bluetooth ».In addition, the Device ID may contain an optional provider string of "usb" or "bluetooth".

L’élément de type de fonction spécifie la fonction de l’appareil.The Function Type element specifies the device function. Cet élément contient une ou plusieurs valeurs d’utilisation HID.This element contains one or more HID usage values. Ces valeurs se composent d’une page d’utilisation et d’un ID d’utilisationfacultatif, chacun d’entre eux étant des valeurs hexadécimales de 16 bits.These values consist of a Usage Page and an optional Usage Id, each of which are 16-bit hexadecimal values.

Exemple de DeviceCapabilitiesExample DeviceCapabilities

Cette section contient des exemples d’entrées DeviceCapabilities pour trois périphériques HID.This section contains example DeviceCapabilities entries for three HID devices. Les deux premières correspondent à une utilisation définie par le fournisseur sur un périphérique HID, le troisième à l’appareil de jeu (dans la page des contrôles de jeu) et le quatrième à un joystick et à un boîtier de jeu.The first two correspond to a vendor-defined usage on a HID device, the third to gaming device (in the Game Controls page), and the fourth to a joystick and a game pad.

Dans les données d’utilisation définies par le fournisseur suivantes, l’appareil est identifié par la combinaison ID du fournisseur et ID du produit .In the following vendor-defined usage data, the device is identified by the Vendor Id and Product Id combination.

<!-- HID Device -->
<DeviceCapability Name="humaninterfacedevice">
    <Device Id="vidpid:0A81 0701">
      <Function Type="usage:ffa0 0001"/>
    </Device>
</DeviceCapability>

Les éléments suivants sont identiques à la première, à l’exception de la chaîne de fournisseur supplémentaire (« USB ») dans l’élément ID d’appareil .The following is identical to the first with the exception of the additional provider string ("usb") in the Device Id element.

<!-- HID Device -->
<DeviceCapability Name="humaninterfacedevice">
    <Device Id="vidpid:0A81 0701 usb">
      <Function Type="usage:ffa0 0001"/>
    </Device>
</DeviceCapability>

Dans les données de périphérique de jeu suivantes, il n’y a pas d' ID de fournisseur et d' ID de produit.In the following gaming-device data there is no Vendor Id and Product Id.

<!-- Any gamepad device  -->
<DeviceCapability Name="humaninterfacedevice">
    <Device Id="any">
      <Function Type="usage:0005 *"/>
    </Device>
</DeviceCapability>

Dans les données de la manette de jeu et du boîtier de jeu suivantes, il n’y a pas d' ID de fournisseur et d' ID de produitIn the following joystick and game pad data there is no Vendor Id and Product Id

<!-- Any generic gaming device  -->
<DeviceCapability Name="humaninterfacedevice">
    <Device Id="any">
      <Function Type="usage:0004 *"/>
      <Function Type="usage:0005 *"/>
    </Device>
</DeviceCapability>

Configuration requise pour les applications de téléphone Windows 8. xRequirements for Windows 8.x Phone apps

Les applications Windows 8. x Phone peuvent accéder à l’API Windows. Devices. HumanInterfaceDevice si le fabricant a pris en charge le protocole HID pour des appareils spécifiques et fourni les données de périphérique correspondantes aux développeurs d’applications.Windows 8.x Phone apps can access the Windows.Devices.HumanInterfaceDevice API if the manufacturer supported the HID protocol for specific devices and provided corresponding device-data to app developers. Reportez-vous à la documentation de votre fabricant pour obtenir la liste des périphériques HID pris en charge, ainsi que les données dont vous aurez besoin pour implémenter la découverte des appareils.Refer to your manufacturer’s documentation for a list of supported HID devices as well as the data that you’ll need to implement device discovery.

Windows. Devices. HumanInterfaceDeviceWindows.Devices.HumanInterfaceDevice