Windows.Devices.HumanInterfaceDevice Namespace

Esse namespace fornece ao aplicativo UWP acesso a dispositivos que dão suporte ao protocolo HID (Dispositivo de Interface Humana ).

Suporte ao dispositivo

Esse namespace dá suporte à maioria dos HIDs. No entanto, ele não fornece acesso a TLCs (coleções de aplicativos de nível superior) representadas pelos seguintes usos.

Usos inacessíveis.

• Dispositivos de teclado e mouse são dispositivos reservados ao sistema
• Os HIDs de LampArray podem ser enumerados com HidDevice.GetDeviceSelector , mas devem ser instanciados com LampArray.FromIdAsync
• Os HIDs do sensor podem ser enumerados com HidDevice.GetDeviceSelector , mas devem ser instanciados com seu respectivo dispositivo Windows.Devices.Sensors (por exemplo , LightSensor.FromIdAsync)

Funcionalidades do dispositivo de interface humana

Um aplicativo UWP que acessa um HID deve incluir dados de funcionalidade de dispositivo específicos no nó de funcionalidades de seu manifesto. Esses dados identificam o dispositivo e sua finalidade (ou função). Observe que alguns dispositivos podem ter várias funções.

Desde Windows 10, versão 1809 (Atualização de outubro de 2018)

• <DeviceCapability>: o atributo Name deve ser humanInterfaceDevice.

<DeviceCapability Name="humanInterfaceDevice"/>

Se estiver direcionando um dispositivo de telefonia HID (UsagePage==0x0B), a funcionalidade hidTelephony adicional também deverá ser especificada.

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

Antes de Windows 10, versão 1809 (Atualização de outubro de 2018)

Desde 1809, o ProductId vendorId/ e o tipo de função não precisam mais ser especificados e serão ignorados em sistemas mais recentes. Se estiver direcionando sistemas antes de 1809, veja abaixo.

• <DeviceCapability>: o atributo Name deve ser humanInterfaceDevice.

  • <Dispositivo>: o atributo Id deve especificar o identificador do dispositivo. Esse elemento pode especificar uma combinação de ID do Fornecedor (vid) e ID do Produto (pid); ou pode especificar uma cadeia anyde caracteres genérica . Além disso, o Device Id pode conter uma cadeia de caracteres de provedor opcional de usb ou bluetooth.

    • <Função>: o atributo Type especifica a função do dispositivo. Esse elemento contém um ou mais valores de uso hid. Esses valores consistem em um UsagePage e um opcional UsageId, cada um dos quais são valores hexadecimal de 16 bits.

Nos seguintes dados de uso definidos pelo fornecedor, o dispositivo é identificado pela combinação ID do Fornecedor e ID do Produto .

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

O seguinte é idêntico ao primeiro, com exceção da cadeia de caracteres de provedor usb adicional no Device Id elemento .

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

Nos dados do dispositivo de jogos a seguir, não há ID do fornecedor e ID do produto.

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

Nos seguintes dados do joystick e do game pad, não há nenhuma ID do Fornecedor e ID do Produto

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

Solução de problemas

• Verifique se a funcionalidade HID (humanInterfaceDevice) está no manifesto do aplicativo. Se um dispositivo de telefonia, verifique se a hidTelephony funcionalidade também está incluída.
• Verifique se o usuário concedeu permissão para o aplicativo utilizar HIDs.
• Verifique se o tipo de dispositivo não é um designado como inacessível.
  • HIDs inacessíveis ainda podem ser enumerados por DeviceInformation.FindAllAsync(), mas não podem ser abertos por HumanInterfaceDevice.FromIdAsync(). O attemping para abrir esse dispositivo gerará uma exceção ou retornará null.
• Os dispositivos internos do computador (DEVPKEY_Device_InLocalMachineContainer == TRUE) geralmente não são acessíveis, a menos que sejam executados em um SKU com o modo elowLevelDevices a funcionalidade inseridos.
• Os dispositivos com pilhas que contêm drivers de filtro superior/inferior geralmente não são acessíveis. Às vezes, eles são adicionados por terceiros para habilitar funcionalidades adicionais para hardware personalizado.
  • A restrição de dispositivo é parcialmente determinada por hidclass.sys durante a enumeração do dispositivo, que pode definir a propriedade DEVPKEY_DeviceInterface_Restricted de interface do dispositivo como TRUE na Interface GUID_DEVINTERFACE_HID do Dispositivo HID com base na presença de filtros de dispositivo/classe.
  • A presença de drivers UpperFilter/LowerFilter do dispositivo pode ser determinada usando DeviceManager procurando UpperFilters propriedades e LowerFilters .
  • A presença dos drivers UpperFilter/LowerFilter da classe HID pode ser determinada usando DeviceManager procurando Class upper filters propriedades e Class lower filters .
  • As propriedades da Interface do Dispositivo podem ser inspecionadas chamando CM_Get_Device_Interface_Property onde pszDeviceInterface é a mesma cadeia de caracteres que seria passada para FromIdAsync.
• Essas restrições podem ser ignoradas ao criar um dispositivo personalizado trabalhando com o driver-desenvolvedor para criar um aplicativo de suporte de hardware