Angeben von Gerätefunktionen für HID

  • Artikel

Hinweis Informationen zu Windows 10 finden Sie unter Unterschiede in Windows 10.

 

Das Paketmanifest ist ein XML-Dokument, das die Informationen enthält, die das System zum Bereitstellen, Anzeigen oder Aktualisieren einer Windows-Runtime-App benötigt. Diese Informationen umfassen Paketidentität, Paketabhängigkeiten, erforderliche Funktionen, visuelle Elemente und Erweiterungspunkte. Jedes App-Paket muss ein Paketmanifest enthalten.

Eine Windows-Runtime-App, die auf ein HID-Gerät zugreift, muss bestimmte DeviceCapability-Daten im Knoten Funktionen des 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.

Das Device Id-Element entspricht dem Gerätebezeichner. Dieses Element kann eine Kombination aus Vendor Id (vid) und Product Id (pid) angeben. oder es kann eine generische Zeichenfolge ("any") angeben. Darüber hinaus kann die Geräte-ID eine optionale Anbieterzeichenfolge "usb" oder "bluetooth" enthalten.

Das Function Type-Element gibt die Gerätefunktion an. Dieses Element enthält mindestens einen HID-Verwendungswert. Diese Werte bestehen aus einer Nutzungsseite und einer optionalen Nutzungs-ID, die jeweils 16-Bit-Hexadezimalwerte sind.

DeviceCapabilities-Beispiel

Dieser Abschnitt enthält DeviceCapabilities-Beispieleinträge für drei HID-Geräte. Die ersten beiden entsprechen einer vom Hersteller definierten Nutzung auf einem HID-Gerät, das dritte dem Gaminggerät (auf der Seite Spielsteuerungen) und das vierte einem Spiel und einem Spielpad.

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

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

Das folgende Ist mit dem ersten identisch, mit Ausnahme der zusätzlichen Anbieterzeichenfolge ("usb") im Device Id-Element .

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

In den folgenden Gaminggerätedaten sind keine Anbieter-ID und keine Produkt-ID vorhanden.

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

In den folgenden Daten des Spiel- und Spielpads sind keine Anbieter-ID und produkt-ID vorhanden.

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

Anforderungen für Windows 8.x-Telefon-Apps

Windows 8.x Telefon-Apps können auf die Windows zugreifen. Devices.HumanInterfaceDevice-API, wenn der Hersteller das HID-Protokoll für bestimmte Geräte unterstützt und entsprechende Gerätedaten für App-Entwickler bereitgestellt hat. Eine Liste der unterstützten HID-Geräte sowie die Daten, die Sie zum Implementieren der Geräteermittlung benötigen, finden Sie in der Dokumentation Ihres Herstellers.

Windows.Devices.HumanInterfaceDevice