DeviceCapability (Windows 10)

Artikel
02/01/2024

Deklariert eine Gerätefunktion, die für ein Paket erforderlich ist. Auf Windows 10.0.10240.0 können bis zu 100 Geräteelemente enthalten sein. Auf Windows 10.0.10586.0 kann bis zu 1000 enthalten (beispiele für Syntax und Beispiele).

Elementhierarchie

<Paket>

<DeviceCapability>

Syntax

<DeviceCapability
    Name = 'A string with a value between 1 and 50 characters in length or a GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.' >

  <!-- Child elements -->
  Device{0,1000}

</DeviceCapability>

Schlüssel

{} bestimmter Vorkommenbereich

Attribute und Elemente

Attributes

attribute	BESCHREIBUNG	Datentyp	Erforderlich	Standardwert
Name	Der Name der Gerätefunktion, entweder als Anzeigename oder als GUID der Geräteschnittstellenklasse angegeben.	Eine Zeichenfolge mit einem Wert zwischen 1 und 50 Zeichen länge oder einer GUID im Formular xx-xxxx-xxxx-xxxx-xxxx-xx.	Ja

Untergeordnete Elemente

Untergeordnetes Element	Beschreibung
Device	Deklariert eine Funktion für ein Gerät, das der DeviceCapability zugeordnet ist. Auf Windows 10.0.10240.0 kann eine DeviceCapability bis zu 100 Geräteelemente enthalten. Auf Windows 10.0.10586.0 kann es bis zu 1000 enthalten (weitere Details finden Sie unter DeviceCapability).

Übergeordnete Elemente

Übergeordnetes Element	Beschreibung
Capabilities	Deklariert den Zugriff auf geschützte Benutzerressourcen, die das Paket benötigt. Sie können mehrere DeviceCapability - und Capability-Elemente im Capabilities-Element haben, aber alle DeviceCapability-Elemente müssen nach den Capability-Elementen kommen.

Bemerkungen

Wenn das Name-Attribut als GUID angegeben wird, wird es als GUID überprüft.

Apps werden standardmäßig Zugriff auf einige Geräte gewährt. Um auf andere Gerätetypen zuzugreifen, müssen Sie sie mithilfe eines DeviceCapability-Elements angeben. Einige Gerätefunktionen müssen dem Paketmanifest manuell hinzugefügt werden. Weitere Informationen finden Sie unter So wird's gemacht: Angeben von Gerätefunktionen in einem Paketmanifest.

Weitere Informationen zu Funktionsdeklarationen finden Sie unter App-Funktionsdeklarationen.

Die folgenden Gerätefunktionen erfordern untergeordnete Elemente.

Gerätefunktion	Beschreibung
Usb	Bietet Zugriff auf APIs im Windows.Devices.Usb-Namespace . Diese Funktion erfordert untergeordnete Elemente. Weitere Informationen finden Sie unter Aktualisieren des App-Manifestpakets für ein USB-Gerät.
humaninterfacedevice	Bietet Zugriff auf APIs im Windows.Devices.HumanInterfaceDevice-Namespace . Diese Funktion erfordert untergeordnete Elemente. Weitere Informationen finden Sie unter So wird's gemacht: Angeben von Gerätefunktionen für HID.
bluetooth.genericAttributeProfile	Bietet Zugriff auf APIs im Windows.Devices.Bluetooth.GenericAttributeProfile-Namespace . Diese Funktion erfordert untergeordnete Elemente. Weitere Informationen finden Sie unter So wird's gemacht: Angeben von Gerätefunktionen für Bluetooth.
bluetooth.rfcomm	Bietet Zugriff auf APIs im Windows.Devices.Bluetooth.Rfcomm-Namespace . Diese Funktion erfordert untergeordnete Elemente. Weitere Informationen finden Sie unter So wird's gemacht: Angeben von Gerätefunktionen für Bluetooth.

Beispiele

Hier ist ein Beispiel für einen Funktionenknoten, der sowohl für Windows 10.0.10240.0 als auch für 10.0.10586.0 funktioniert (obwohl Windows 10.0.10240.0 nur die <Geräteelemente> analysiert). Windows 10.0.10586.0 unterstützt dagegen bis zu 100 < Geräteelemente> plus <f2:Device-Elemente> für eine gesamte Ergänzung von 1000.

<Package
    xmlns:f2="http://schemas.microsoft.com/appx/manifest/foundation/windows10/2">
...
<Dependencies>
    <TargetDeviceFamily Name="Windows.Universal" MinVersion="10.0.10240.0" MaxVersionTested="10.0.10586.0"/>
</Dependencies>
...
<Capabilities>
    <DeviceCapability Name="microphone"/>
    <DeviceCapability Name="webcam"/>
    <DeviceCapability Name="<name>">
        <Device Id="id_000" ... />
        ...
        <Device Id="id_099" ... />
        <f2:Device Id="id_100" ... />
        ...
        <f2:Device Id="id_999" ... />
    </DeviceCapability>
</Capabilities>

Wenn Sie nur Windows 10.0.10240.0 unterstützen möchten, benötigen Sie nur das <Device-Element>. Wenn Sie nur Windows 10.0.10586.0 unterstützen möchten, benötigen Sie nur das <f2:Device-Element>.

Weitere Beispiele finden Sie unter Angeben von Gerätefunktionen in einem Paketmanifest.

Siehe auch

Deklarationen von App-Funktionen

Angeben von Gerätefunktionen in einem Paketmanifest

Anforderungen

Element	Wert
Namespace	`http://schemas.microsoft.com/appx/manifest/foundation/windows10`

Freigeben über