Windows.Devices.HumanInterfaceDevice Пространство имен

Это пространство имен предоставляет приложению UWP доступ к устройствам, которые поддерживают протокол HID .

Поддержка устройств

Это пространство имен поддерживает большинство HID. Однако он не предоставляет доступ к коллекциям приложений верхнего уровня (TLC), представленным следующими способами использования.

Недоступное использование.

• Устройства клавиатуры и мыши являются зарезервированными в системе устройствами
• HiD LampArray можно перечислить с помощью HidDevice.GetDeviceSelector, но их необходимо создать с помощью LampArray.FromIdAsync.
• HiD датчика можно перечислить с помощью HidDevice.GetDeviceSelector , но их необходимо создать с соответствующим устройством Windows.Devices.Sensors (например , LightSensor.FromIdAsync).

Возможности устройств с человеческим интерфейсом

Приложение UWP, которое обращается к HID, должно включать определенные данные о возможностях устройства в узел возможностей своего манифеста. Эти данные определяют устройство и его назначение (или функцию). Обратите внимание, что некоторые устройства могут иметь несколько функций.

С Windows 10, версия 1809 (обновление за октябрь 2018 г.)

• <DeviceCapability>: атрибут Name должен иметь значение humanInterfaceDevice.

<DeviceCapability Name="humanInterfaceDevice"/>

При нацеливание на устройство hid телефонии (UsagePage==),0x0B необходимо также указать дополнительную возможность hidTelephony .

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

До Windows 10, версия 1809 (обновление за октябрь 2018 г.)

Начиная с версии 1809, ProductId VendorId/ и тип функции больше не нужно указывать, и они будут игнорироваться в более новых системах. Если нацеливание на системы до 1809, см. ниже.

• <DeviceCapability>: атрибут Name должен иметь значение humanInterfaceDevice.

  • <Устройство>. Атрибут Id должен указывать идентификатор устройства. Этот элемент может указывать сочетание идентификатора поставщика (vid) и идентификатора продукта (pid); или может указать универсальную строку any. Кроме того, Device Id может содержать необязательную строку usb поставщика или bluetooth.

    • <Функция>. Атрибут Type указывает функцию устройства. Этот элемент содержит одно или несколько значений использования HID. Эти значения состоят из UsagePage и необязательных UsageId, каждое из которых является 16-разрядными шестнадцатеричными значениями.

В следующих данных об использовании, определяемых поставщиком, устройство определяется сочетанием идентификатора поставщика и идентификатора продукта .

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

Следующий код идентичен первому за исключением дополнительной строки usb поставщика в элементе Device Id .

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

В следующих данных игрового устройства нет идентификатора поставщика и продукта.

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

В следующих данных джойстика и игровой панели нет идентификатора поставщика и идентификатора продукта.

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

Устранение неполадок

• Убедитесь, что в манифесте приложения есть возможность HID (humanInterfaceDevice). Если устройство телефонии, убедитесь, что hidTelephony эта возможность также включена.
• Убедитесь, что пользователь предоставил приложению разрешение на использование HID.
• Убедитесь, что тип устройства не указан как недоступный.
  • Недоступные HID по-прежнему могут быть перечислены с помощью DeviceInformation.FindAllAsync(), но не могут быть открыты с помощью HumanInterfaceDevice.FromIdAsync(). При открытии такого устройства создается исключение или возвращается null.
• Внутренние устройства компьютера (DEVPKEY_Device_InLocalMachineContainer == TRUE) обычно недоступны, если только они не работают на номере SKU со встроенным режимом и lowLevelDevices возможностями.
• Устройства со стеками, содержащими верхние и нижние драйверы фильтров, как правило, недоступны . Они иногда добавляются сторонними разработчиками для включения дополнительных функций для пользовательского оборудования.
  • Ограничение устройства частично определяется hidclass.sys во время перечисления устройств, которое может присвоить свойству DEVPKEY_DeviceInterface_Restricted интерфейса устройства значение TRUE в интерфейсе GUID_DEVINTERFACE_HID устройства HID в зависимости от наличия фильтров устройства или класса.
  • Наличие драйверов UpperFilterLowerFilter/ устройства можно определить с помощью DeviceManager, выполнив поиск UpperFilters свойств и LowerFilters .
  • Наличие драйверов класса HID UpperFilter/LowerFilter можно определить с помощью DeviceManager, выполнив поиск Class upper filters свойств и Class lower filters .
  • Свойства интерфейса устройства можно проверить путем вызова CM_Get_Device_Interface_Property , где pszDeviceInterface — это та же строка, которая была бы передана в FromIdAsync.
• Эти ограничения можно обойти при создании пользовательского устройства, работая с разработчиком драйвера для создания приложения поддержки оборудования.