Compartilhar via


Como especificar funcionalidades do dispositivo para HID

Observação para Windows 10, consulte o que há de diferente na Windows 10.

 

o manifesto do pacote é um documento XML que contém as informações de que o sistema precisa para implantar, exibir ou atualizar um aplicativo Windows Runtime. Essas informações incluem a identidade do pacote, as dependências do pacote, os recursos necessários, os elementos visuais e os pontos de extensibilidade. Cada pacote de aplicativo deve incluir um manifesto de pacote.

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

O elemento ID do dispositivo corresponde ao identificador do dispositivo. Esse elemento pode especificar uma combinação de ID do fornecedor (vid) e ID do produto (PID); ou, ele pode especificar uma cadeia de caracteres genérica ("any"). Além disso, a ID do dispositivo pode conter uma cadeia de caracteres de provedor opcional de "USB" ou "Bluetooth".

O elemento tipo de função especifica a função do dispositivo. Este elemento contém um ou mais valores de uso de HID. Esses valores consistem em uma página de uso e uma ID de usoopcional, cada um dos quais são valores hexadecimais de 16 bits.

Exemplo de DeviceCapabilities

Esta seção contém entradas DeviceCapabilities de exemplo para três dispositivos HID. Os dois primeiros correspondem a um uso definido pelo fornecedor em um dispositivo HID, o terceiro dispositivo para jogos (na página de controles do jogo) e o quarto de um joystick e um bloco de jogo.

Nos dados de uso definidos pelo fornecedor a seguir, o dispositivo é identificado pela combinação ID do fornecedor e ID do produto .

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

O seguinte é idêntico ao primeiro com a exceção da cadeia de caracteres de provedor adicional ("USB") no elemento ID do dispositivo .

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

No jogo a seguir, dados do dispositivo 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>

No joystick e nos dados do game pad a seguir, não há 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>

requisitos para aplicativos Windows 8. x Telefone

os aplicativos Telefone Windows 8. x podem acessar o Windows. API Devices. HumanInterfaceDevice se o fabricante tiver suporte para o protocolo HID para dispositivos específicos e fornecido dados de dispositivo correspondentes aos desenvolvedores de aplicativos. Consulte a documentação do fabricante para obter uma lista de dispositivos HID com suporte, bem como os dados necessários para implementar a descoberta de dispositivos.

Windows.Devices.HumanInterfaceDevice