Windows.Devices.HumanInterfaceDevice 命名空间

此命名空间允许 UWP 应用访问支持 人机接口设备 (HID) 协议的设备。

设备支持

此命名空间支持大多数 HID。 但是，它不提供对顶级应用程序集合的访问权限， (TLC) 由以下用法表示。

无法访问的使用情况。

• 键盘和鼠标设备是系统保留的设备
• LampArray HID 可以使用 HidDevice.GetDeviceSelector 枚举，但必须使用 LampArray.FromIdAsync 实例化
• 可以使用 HidDevice.GetDeviceSelector 枚举传感器 HID ，但必须使用其各自的 Windows.Devices.Sensors 设备 (实例化，例如 LightSensor.FromIdAsync)

人机接口设备功能

访问 HID 的 UWP 应用必须在其清单的功能节点中包含特定的设备功能数据。 此数据标识设备及其用途 (或功能) 。 请注意，某些设备可能具有多个功能。

自 Windows 10 版本 1809 (2018 年 10 月更新)

• <DeviceCapability>： Name 属性必须为 humanInterfaceDevice。

<DeviceCapability Name="humanInterfaceDevice"/>

如果面向 HID 电话设备 (UsagePage==0x0B) ，则还必须指定附加功能 hidTelephony 。

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

在 2018 年 10 月 Windows 10 版本 1809 (之前更新)

自 1809 年以来，不再需要指定 VendorId/ProductId 和 函数类型 ，并且会在较新的系统上被忽略。 如果面向 1809 之前的系统，请参阅下文。

• <DeviceCapability>： Name 属性必须为 humanInterfaceDevice。

  • <设备>： Id 属性必须指定设备标识符。 此元素可以指定 供应商 ID (vid) 和 产品 ID (pid) ;或者，它可以指定泛型字符串 any。 此外， Device Id 可能包含 或 bluetooth的usb可选提供程序字符串。

    • <函数>： Type 属性指定设备函数。 此元素包含一个或多个 HID 用法值。 这些值由 和可选 UsageId组成UsagePage，每个值都是 16 位十六进制值。

在以下供应商定义的使用情况数据中，设备由 供应商 ID 和 产品 ID 组合标识。

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

以下内容与第一个 相同，但 元素中Device Id附加的提供程序字符串usb除外。

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

在以下游戏设备数据中，没有 供应商 ID 和 产品 ID。

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

在以下游戏杆和游戏板数据中，没有 供应商 ID 和 产品 ID

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

疑难解答

• 验证应用程序清单中 (humanInterfaceDevice) 的 HID 功能。 如果是电话设备，请确保 hidTelephony 还包含该功能。
• 验证用户是否已授予应用程序使用 HID 的权限。
• 验证设备类型是否不是指定为不可访问的设备类型。
  • 不可访问的 HID 仍可能由 DeviceInformation.FindAllAsync () 枚举，但不能由 HumanInterfaceDevice.FromIdAsync () 打开。 尝试打开此类设备会引发异常或返回 null。
• () 的计算机内部设备 DEVPKEY_Device_InLocalMachineContainer == TRUE 通常 无法访问 ，除非在具有 嵌入式模式 和 lowLevelDevices 功能的 SKU 上运行。
• 通常 无法访问 包含上部/下层筛选器驱动程序的堆栈的设备。 第三方有时会添加这些内容，以便为 自定义硬件启用其他功能。
  • 设备限制部分由hidclass.sys在设备枚举期间确定，这可能会根据是否存在设备/类筛选器将 HID 设备接口上的设备接口GUID_DEVINTERFACE_HID属性DEVPKEY_DeviceInterface_Restricted设置为 TRUE 。
  • 可以通过查找 UpperFilters 和 LowerFilters 属性，使用 DeviceManager 确定设备 UpperFilter/LowerFilter 驱动程序是否存在。
  • 可以通过查找 Class upper filters 和 Class lower filters 属性，使用 DeviceManager 确定 HID 类 UpperFilter/LowerFilter 驱动程序是否存在。
  • 可以通过调用 CM_Get_Device_Interface_Property 来检查设备接口属性，其中 pszDeviceInterface 是将传递给 FromIdAsync 的相同字符串。
• 通过与驱动程序开发人员合作创建硬件支持应用来创建自定义设备时，可以绕过这些限制