Windows.Devices.HumanInterfaceDevice Spazio dei nomi

Questo spazio dei nomi consente all'app UWP di accedere ai dispositivi che supportano il protocollo HID (Human Interface Device ).

Supporto dei dispositivi

Questo spazio dei nomi supporta la maggior parte degli HID. Tuttavia, non fornisce l'accesso alle raccolte di applicazioni di primo livello (TLCs) rappresentate dagli utilizzi seguenti.

Utilizzi inaccessibili.

• I dispositivi da tastiera e mouse sono dispositivi riservati del sistema
• Gli HID LampArray possono essere enumerati con HidDevice.GetDeviceSelector , ma devono essere create istanze con LampArray.FromIdAsync
• Gli HID del sensore possono essere enumerati con HidDevice.GetDeviceSelector , ma devono essere create istanze con il rispettivo dispositivo Windows.Devices.Sensors (ad esempio LightSensor.FromIdAsync)

Funzionalità del dispositivo dell'interfaccia umana

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

Dal Windows 10, versione 1809 (aggiornamento di ottobre 2018)

• <DeviceCapability>: l'attributo Name deve essere humanInterfaceDevice.

<DeviceCapability Name="humanInterfaceDevice"/>

Se la destinazione di un dispositivo di telefonia HID (UsagePage===0x0B), è necessario specificare anche la funzionalità hidTelephony aggiuntiva.

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

Prima Windows 10, versione 1809 (aggiornamento di ottobre 2018)

Dal 1809, il ProductId VendorId/ e il tipo di funzione non devono più essere specificati e verranno ignorati nei sistemi più recenti. Se la destinazione dei sistemi è precedente alla versione 1809, vedere di seguito.

• <DeviceCapability>: l'attributo Name deve essere humanInterfaceDevice.

  • <Dispositivo>: l'attributo Id deve specificare l'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, Device Id può contenere una stringa di provider facoltativa di usb o bluetooth.

    • <Funzione>: l'attributo Type specifica la funzione device. Questo elemento contiene uno o più valori di utilizzo HID. Questi valori sono costituiti da e da , UsagePage ognuno UsageIddei quali è un valore esadecimale a 16 bit.

Nei seguenti dati di utilizzo definiti dal fornitore, il dispositivo viene identificato dalla combinazione id fornitore e ID prodotto .

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

Il codice seguente è identico al primo con l'eccezione della stringa usb del provider aggiuntiva nell'elemento Device Id .

<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 seguenti dati del joystick e del 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>

Risoluzione dei problemi

• Verificare che la funzionalità HID (humanInterfaceDevice) sia presente nel manifesto dell'applicazione. Se un dispositivo di telefonia, assicurarsi che sia inclusa anche la hidTelephony funzionalità.
• Verificare che all'utente sia stata concessa l'autorizzazione per l'utilizzo degli HID da parte dell'applicazione.
• Verificare che il tipo di dispositivo non sia designato come inaccessibile.
  • Gli HID inaccessibili possono comunque essere enumerati da DeviceInformation.FindAllAsync(), ma non possono essere aperti da HumanInterfaceDevice.FromIdAsync(). L'attemping per aprire un dispositivo di questo tipo genererà un'eccezione o restituirà null.
• I dispositivi interni del computer (DEVPKEY_Device_InLocalMachineContainer == TRUE) in genere non sono accessibili a meno che non vengano eseguiti in uno SKU con modalità incorporata e lowLevelDevices funzionalità.
• I dispositivi con stack che contengono driver di filtro superiore/inferiore non sono in genere accessibili. Questi vengono talvolta aggiunti da terze parti per abilitare funzionalità aggiuntive per l'hardware personalizzato.
  • La restrizione del dispositivo è parzialmente determinata durante hidclass.sys l'enumerazione del dispositivo, che può impostare la proprietà DEVPKEY_DeviceInterface_RestrictedTRUE dell'interfaccia del dispositivo su nell'interfaccia GUID_DEVINTERFACE_HID del dispositivo HID in base alla presenza di filtri di dispositivo/classe.
  • La presenza di driver UpperFilter LowerFilter/ può essere determinata usando DeviceManager cercandoUpperFilters le proprietà e .LowerFilters
  • La presenza di driverUpperFilter LowerFilter/ della classe HIDpuò essere determinata tramite DeviceManager cercando Class upper filters proprietà e Class lower filters .
  • È possibile controllare le proprietà dell'interfaccia del dispositivo chiamando CM_Get_Device_Interface_Property dove pszDeviceInterface è la stessa stringa che verrebbe passata a FromIdAsync.
• Queste restrizioni possono essere ignorate quando si crea un dispositivo personalizzato usando il driver-sviluppatore per creare un'app di supporto hardware