Windows.Devices.HumanInterfaceDevice Namespace

Dieser Namespace ermöglicht Ihrer UWP-App Zugriff auf Geräte, die das HID-Protokoll (Human Interface Device) unterstützen.

Geräteunterstützung

Dieser Namespace unterstützt die meisten HIDs. Es bietet jedoch keinen Zugriff auf die obersten Anwendungssammlungen (TLCs), die durch die folgenden Verwendungen dargestellt werden.

Nicht zugängliche Verwendungen.

• Tastatur- und Mausgeräte sind vom System reservierte Geräte.
• LampArray-HIDs können mit HidDevice.GetDeviceSelector aufgelistet werden, müssen jedoch mit LampArray.FromIdAsync instanziiert werden.
• Sensor-HIDs können mit HidDevice.GetDeviceSelector aufgelistet werden, müssen jedoch mit dem jeweiligen Windows.Devices.Sensors-Gerät instanziiert werden (z. B. LightSensor.FromIdAsync).

Funktionen von Human Interface-Geräten

Eine UWP-App, die auf eine HID zugreift, muss bestimmte Gerätefunktionsdaten im Funktionsknoten ihres Manifests enthalten. Diese Daten identifizieren das Gerät und seinen Zweck (oder seine Funktion). Beachten Sie, dass einige Geräte möglicherweise über mehrere Funktionen verfügen.

Seit Windows 10, Version 1809 (Oktober 2018 Update)

• <DeviceCapability>: Das Name-Attribut muss sein humanInterfaceDevice.

<DeviceCapability Name="humanInterfaceDevice"/>

Wenn sie auf ein HID-Telefoniegerät abzielen (UsagePage==0x0B), muss auch die zusätzliche Funktion hidTelephony angegeben werden.

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

Vor Windows 10, Version 1809 (Update vom Oktober 2018)

Seit 1809 müssen die VendorId/ProductId und der Funktionstyp nicht mehr angegeben werden und werden auf neueren Systemen ignoriert. Wenn Systeme vor 1809 anvisieren, sehen Sie sich unten an.

• <DeviceCapability>: Das Name-Attribut muss sein humanInterfaceDevice.

  • <Gerät>: Das Id-Attribut muss den Gerätebezeichner angeben. Dieses Element kann eine Kombination von Anbieter-ID (vid) und Produkt-ID (pid) angeben. oder kann eine generische Zeichenfolge anyangeben. Darüber hinaus kann die Device Id eine optionale Anbieterzeichenfolge von usb oder bluetoothenthalten.

    • <Funktion>: Das Type-Attribut gibt die Gerätefunktion an. Dieses Element enthält mindestens einen HID-Nutzungswert. Diese Werte bestehen aus einem UsagePage und einem optionalen UsageId, die jeweils 16-Bit-Hexadezimalwerte sind.

In den folgenden vom Hersteller definierten Nutzungsdaten wird das Gerät durch die Kombination Anbieter-ID und Produkt-ID identifiziert.

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

Das Folgende ist mit der ersten identisch, mit Ausnahme der zusätzlichen Anbieterzeichenfolge usb im Device Id -Element.

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

In den folgenden Gaming-Gerätedaten gibt es keine Anbieter-ID und Keine Produkt-ID.

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

In den folgenden Joystick- und Spielpaddaten befinden sich keine Anbieter-ID und keine Produkt-ID

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

Problembehandlung

• Vergewissern Sie sich, dass sich die HID-Funktion (humanInterfaceDevice) im Anwendungsmanifest befindet. Wenn ein Telefoniegerät vorhanden ist, stellen Sie sicher, dass die hidTelephony Funktion ebenfalls enthalten ist.
• Überprüfen Sie, ob der Benutzer der Anwendung die Berechtigung erteilt hat, HIDs zu verwenden.
• Vergewissern Sie sich, dass der Gerätetyp nicht als nicht zugänglich gekennzeichnet ist.
  • Nicht zugängliche HIDs werden möglicherweise weiterhin von DeviceInformation.FindAllAsync()aufgelistet, können aber nicht von HumanInterfaceDevice.FromIdAsync()geöffnet werden. Durch das Attemping zum Öffnen eines solchen Geräts wird entweder eine Ausnahme ausgelöst oder zurückgegeben null.
• Auf computerinterne Geräte (DEVPKEY_Device_InLocalMachineContainer == TRUE) kann im Allgemeinen nur zugegriffen werden, wenn sie auf einer SKU mit eingebettetem Modus und lowLevelDevices Funktionen ausgeführt werden.
• Geräte mit Stapeln, die obere/niedrigere Filtertreiber enthalten, sind in der Regel nicht zugänglich. Diese werden manchmal von dritten Parteien hinzugefügt, um zusätzliche Funktionen für benutzerdefinierte Hardware zu aktivieren.
  • Die Geräteeinschränkung wird teilweise durch hidclass.sys die Geräteaufzählung bestimmt, wodurch die Geräteschnittstelleneigenschaft DEVPKEY_DeviceInterface_RestrictedTRUE auf der HID-Geräteschnittstelle GUID_DEVINTERFACE_HID basierend auf dem Vorhandensein von Geräte-/Klassenfiltern festgelegt werden kann.
  • Das Vorhandensein von UpperFilter/LowerFilter-Treibern des Geräts kann mithilfe von DeviceManager ermittelt werden, indem Nach und LowerFilters Eigenschaften gesucht UpperFilters werden.
  • Das Vorhandensein von Treibern der HID-Klasse UpperFilter/LowerFilter kann mithilfe von DeviceManager ermittelt werden, indem Sie nach eigenschaften und Class lower filters suchenClass upper filters.
  • Geräteschnittstelleneigenschaften können überprüft werden, indem aufgerufen CM_Get_Device_Interface_Property wird, wobei pszDeviceInterface dieselbe Zeichenfolge wie an FromIdAsync übergeben wird.
• Diese Einschränkungen können beim Erstellen eines benutzerdefinierten Geräts umgangen werden, indem Sie mit dem Treiberentwickler zusammenarbeiten, um eine Hardwaresupport-App zu erstellen.