Windows.Devices.HumanInterfaceDevice Espace de noms

Cet espace de noms permet à votre application UWP d’accéder aux appareils qui prennent en charge le protocole HID (Human Interface Device).

Prise en charge des appareils

Cet espace de noms prend en charge la plupart des HID. Toutefois, il ne fournit pas l’accès aux collections d’applications de niveau supérieur (TLC) représentées par les utilisations suivantes.

Utilisations inaccessibles.

• Les périphériques clavier et souris sont des appareils réservés au système
• Les HID LampArray peuvent être énumérées avec HidDevice.GetDeviceSelector, mais doivent être instanciées avec LampArray.FromIdAsync
• Les HID de capteur peuvent être énumérés avec HidDevice.GetDeviceSelector , mais doivent être instanciés avec leur appareil Windows.Devices.Sensors respectif (par exemple , LightSensor.FromIdAsync)

Fonctionnalités de l’appareil d’interface humaine

Une application UWP qui accède à un fichier HID doit inclure des données de capacité d’appareil spécifiques dans le nœud de fonctionnalités de son manifeste. Ces données identifient l’appareil et son objectif (ou fonction). Notez que certains appareils peuvent avoir plusieurs fonctions.

Depuis Windows 10, version 1809 (mise à jour d’octobre 2018)

• <DeviceCapability> : l’attribut Name doit être humanInterfaceDevice.

<DeviceCapability Name="humanInterfaceDevice"/>

Si vous ciblez un appareil de téléphonie HID (UsagePage==0x0B), la fonctionnalité hidTelephony supplémentaire doit également être spécifiée.

<DeviceCapability Name="humanInterfaceDevice"/>
<DeviceCapability Name="hidTelephony"/>

Avant Windows 10, version 1809 (mise à jour d’octobre 2018)

Depuis 1809, le ProductId vendorId/ et le type de fonction n’ont plus besoin d’être spécifiés et seront ignorés sur les systèmes plus récents. Si vous ciblez des systèmes avant 1809, voir ci-dessous.

• <DeviceCapability> : l’attribut Name doit être humanInterfaceDevice.

  • <Appareil> : l’attribut Id doit spécifier l’identificateur de l’appareil. Cet élément peut spécifier une combinaison d’ID de fournisseur (vid) et d’ID de produit (pid) ; ou bien, il peut spécifier une chaîne anygénérique . En outre, peut Device Id contenir une chaîne de fournisseur facultative de usb ou bluetooth.

    • <Fonction> : l’attribut Type spécifie la fonction d’appareil. Cet élément contient une ou plusieurs valeurs d’utilisation HID. Ces valeurs se composent d’un UsagePage et d’un facultatif UsageId, qui sont chacune des valeurs hexadécimales 16 bits.

Dans les données d’utilisation définies par le fournisseur suivantes, l’appareil est identifié par la combinaison ID de fournisseur et ID de produit .

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

L’élément suivant est identique au premier, à l’exception de la chaîne usb de fournisseur supplémentaire dans l’élément Device Id .

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

Dans les données d’appareil 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 manette de jeu et de manette 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>

Résolution des problèmes

• Vérifiez que la fonctionnalité HID (humanInterfaceDevice) figure dans le manifeste de l’application. Si vous utilisez un appareil de téléphonie, vérifiez que la hidTelephony fonctionnalité est également incluse.
• Vérifiez que l’utilisateur a accordé l’autorisation à l’application d’utiliser des HID.
• Vérifiez que le type d’appareil n’est pas désigné comme inaccessible.
  • Les HID inaccessibles peuvent toujours être énumérés par DeviceInformation.FindAllAsync(), mais ne peuvent pas être ouverts par HumanInterfaceDevice.FromIdAsync(). L’attemps d’ouverture d’un tel appareil lève une exception ou retourne null.
• Les appareils internes à l’ordinateur (DEVPKEY_Device_InLocalMachineContainer == TRUE) ne sont généralement pas accessibles, sauf s’ils s’exécutent sur une référence SKU avec le mode et lowLevelDevices la fonctionnalité incorporés.
• Les appareils avec des piles qui contiennent des pilotes de filtre supérieur/inférieur ne sont généralement pas accessibles. Ceux-ci sont parfois ajoutés par des tiers pour activer des fonctionnalités supplémentaires pour le matériel personnalisé.
  • La restriction d’appareil est partiellement déterminée par hidclass.sys lors de l’énumération de l’appareil, ce qui peut définir la propriété DEVPKEY_DeviceInterface_RestrictedTRUE d’interface de l’appareil sur sur l’interface GUID_DEVINTERFACE_HID d’appareil HID en fonction de la présence de filtres d’appareil/classe.
  • La présence de pilotes UpperFilter/LowerFilter d’appareil peut être déterminée à l’aide de DeviceManager en recherchant UpperFilters les propriétés et LowerFilters .
  • La présence de pilotes UpperFilter/LowerFilter de classe HID peut être déterminée à l’aide de DeviceManager en recherchant Class upper filters des propriétés et Class lower filters .
  • Les propriétés de l’interface d’appareil peuvent être inspectées en appelant CM_Get_Device_Interface_Property où pszDeviceInterface est la même chaîne que celle qui serait passée à FromIdAsync.
• Ces restrictions peuvent être contournées lors de la création d’un appareil personnalisé en travaillant avec le pilote-développeur pour créer une application de support matériel