Come specificare le funzionalità dei dispositivi per HID

  • Articolo

Nota Per Windows 10, vedere Novità di Windows 10.

 

Il manifesto del pacchetto è un documento XML che contiene le informazioni necessarie al sistema per distribuire, visualizzare o aggiornare un Windows Runtime app. Queste informazioni includono l'identità del pacchetto, le dipendenze del pacchetto, le funzionalità necessarie, gli elementi visivi e i punti di estendibilità. Ogni pacchetto dell'app deve includere un manifesto del pacchetto.

Un Windows Runtime app che accede a un dispositivo HID deve includere dati DeviceCapability specifici nel nodo Funzionalità del relativo manifesto. Questi dati identificano il dispositivo e il relativo scopo (o funzione). Si noti che alcuni dispositivi possono avere più funzioni.

L'elemento Device Id corrisponde all'identificatore del dispositivo. Questo elemento può specificare una combinazione di ID fornitore (vid) e ID prodotto (pid); oppure può specificare una stringa generica ("any"). Inoltre, l'ID dispositivo può contenere una stringa del provider facoltativa "usb" o "bluetooth".

L'elemento Function Type specifica la funzione del dispositivo. Questo elemento contiene uno o più valori di utilizzo HID. Questi valori sono costituiti da una pagina di utilizzo e da un ID di utilizzo facoltativo, ognuno dei quali è costituito da valori esadecimali a 16 bit.

DeviceCapabilities di esempio

Questa sezione contiene voci DeviceCapabilities di esempio per tre dispositivi HID. I primi due corrispondono a un utilizzo definito dal fornitore in un dispositivo HID, il terzo al dispositivo di gioco (nella pagina Game Controls) e il quarto a un joystick e a un game pad.

Nei dati di utilizzo definiti dal fornitore seguenti il dispositivo è identificato dalla combinazione di ID fornitoree ID prodotto.

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

Quanto segue è identico al primo, ad eccezione della stringa del provider aggiuntiva ("usb") nell'elemento Device Id .

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

Nei dati del dispositivo di gioco seguenti non sono presenti ID fornitore e ID prodotto.

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

Nei dati seguenti di game pad non sono presenti ID fornitore e ID prodotto

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

Requisiti per Windows 8.x Telefono app

Windows 8.x Telefono le app possono accedere alla Windows. API Devices.HumanInterfaceDevice se il produttore supporta il protocollo HID per dispositivi specifici e fornisce i dati del dispositivo corrispondenti agli sviluppatori di app. Per un elenco dei dispositivi HID supportati e dei dati necessari per implementare l'individuazione dei dispositivi, vedere la documentazione del produttore.

Windows.Devices.HumanInterfaceDevice