Guide pratique pour spécifier les capacités d’un appareil pour HID

Remarque pour Windows 10, consultez la rubrique relative aux différences de 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. 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é. Chaque package d’application doit inclure un manifeste de package.

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. Ces données identifient l’appareil et son objectif (ou fonction). Notez que certains appareils peuvent avoir plusieurs fonctions.

L’élément ID de l' appareil correspond à l’identificateur de l’appareil. 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 »). En outre, l' ID d’appareil peut contenir une chaîne de fournisseur facultative « USB » ou « Bluetooth ».

L’élément de type de fonction spécifie la fonction de l’appareil. Cet élément contient une ou plusieurs valeurs d’utilisation HID. 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.

Exemple de DeviceCapabilities

Cette section contient des exemples d’entrées DeviceCapabilities pour trois périphériques HID. 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.

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 .

<!-- 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 .

<!-- 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.

<!-- 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 produit

<!-- 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. x

Windows 8. x Téléphone applications peuvent accéder au Windows. API 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. 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.

Rubriques connexes

Windows.Devices.HumanInterfaceDevice