Devicecapability (Windows 10)DeviceCapability (Windows 10)

Deklariert eine für ein Paket erforderliche Geräte Funktion.Declares a device capability required by a package. Unter Windows 10.0.10240.0 kann bis zu 100 Geräte Elemente enthalten.On Windows 10.0.10240.0, can contain up to 100 Device elements. Unter Windows 10.0.10586.0 kann bis zu 1000 enthalten (Syntax und Beispiele finden Sie unter Beispiele).On Windows 10.0.10586.0, can contain up to 1000 (for syntax and examples, see Examples).

ElementhierarchieElement hierarchy

<Paketen>
<Package>
<Eigenschaften>
<Capabilities>
<DeviceCapability><DeviceCapability>

SyntaxSyntax

<DeviceCapability Name = A string 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üsselKey

{} bestimmter Bereich von vorkommen{} specific range of occurrences

Attribute und ElementeAttributes and Elements

AttributesAttributes

attributeAttribute BeschreibungDescription DatentypData type ErforderlichRequired StandardwertDefault value
NameName

Der Name der Geräte Funktion, entweder als Anzeige Name oder als GUID einer Geräteschnittstellen Klasse angegeben.The name of the device capability, either specified as a friendly name or a device interface class GUID.

Eine Zeichenfolge, die zwischen 1 und 50 Zeichen lang ist, oder eine GUID in der Form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.A string between 1 and 50 characters in length or a GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. JaYes

Untergeordnete ElementeChild Elements

Untergeordnetes ElementChild Element BESCHREIBUNGDescription
Schutz Device

Deklariert eine Funktion für ein Gerät, das der " endvicecapability " zugeordnet ist.Declares a function for a device that is associated with the DeviceCapability . Unter Windows 10.0.10240.0 kann eine devicecapability bis zu 100 Geräte Elemente enthalten.On Windows 10.0.10240.0, a DeviceCapability can contain up to 100 Device elements. Unter Windows 10.0.10586.0 kann Sie bis zu 1000 enthalten (Weitere Informationen finden Sie unter devicecapability).On Windows 10.0.10586.0, it can contain up to 1000 (for more details, see DeviceCapability).

Übergeordnete ElementeParent Elements

Übergeordnetes ElementParent Element BeschreibungDescription
Eigenschaften Capabilities

Deklariert den Zugriff auf geschützte Benutzerressourcen, die für das Paket erforderlich sind.Declares the access to protected user resources that the package requires. Sie können über mehrere devicecapability -und Capability-Elemente im Capability -Element verfügen , aber alle devicecapability -Elemente müssen nach den Funktions Elementen stehen.You can have multiple DeviceCapability and Capability elements in the Capabilities element, but all DeviceCapability elements must come after the Capability elements.

HinweiseRemarks

Wenn das Name -Attribut als GUID angegeben ist, wird es als GUID überprüft.If the Name attribute is specified as a GUID, then it is validated as GUID.

Apps wird standardmäßig Zugriff auf einige Geräte gewährt.Apps are granted access to some devices by default. Für den Zugriff auf andere Arten von Geräten müssen Sie diese mithilfe eines " Debug"-Elements angeben.To access other types of devices, you must specify them using a DeviceCapability element. Einige Gerätefunktionen müssen manuell zum Paket Manifest hinzugefügt werden.Some device capabilities must be added to the package manifest manually. Weitere Informationen finden Sie unter So wird's gemacht: Angeben von Gerätefunktionen in einem Paketmanifest.For more info, see How to specify device capabilities in a package manifest.

Weitere Informationen zu Funktions Deklarationen finden Sie unter Deklarationen von App-Funktionen.For more info about capability declarations, see App capability declarations.

Die folgenden Gerätefunktionen erfordern untergeordnete Elemente.The following device capabilities require child elements.

GerätefunktionDevice capability BeschreibungDescription
Stickusb Ermöglicht den Zugriff auf APIs im Windows. Devices. USB- Namespace.Provides access to APIs in the Windows.Devices.Usb namespace. Diese Funktion erfordert untergeordnete Elemente.This capability requires child elements. Weitere Informationen finden Sie unter Aktualisieren des App-Manifest-Pakets für ein USB-Gerät.For more info, see Updating the app manifest package for a USB device.
humaninterfacedevicehumaninterfacedevice Ermöglicht den Zugriff auf APIs im Windows. Devices. humaninterfacedevice -Namespace.Provides access to APIs in the Windows.Devices.HumanInterfaceDevice namespace. Diese Funktion erfordert untergeordnete Elemente.This capability requires child elements. Weitere Informationen finden Sie unter So wird's gemacht: Angeben von Gerätefunktionen für HID.For more info, see How to specify device capabilities for HID.
Bluetooth. generiertributeprofilebluetooth.genericAttributeProfile Bietet Zugriff auf APIs im Windows. Devices. Bluetooth. generiertributeprofile -Namespace.Provides access to APIs in the Windows.Devices.Bluetooth.GenericAttributeProfile namespace. Diese Funktion erfordert untergeordnete Elemente.This capability requires child elements. Weitere Informationen finden Sie unter So wird's gemacht: Angeben von Gerätefunktionen für Bluetooth.For more info, see How to specify device capabilities for Bluetooth.
Bluetooth. RFCOMMbluetooth.rfcomm Ermöglicht den Zugriff auf APIs im Windows. Devices. Bluetooth. RFCOMM -Namespace.Provides access to APIs in the Windows.Devices.Bluetooth.Rfcomm namespace. Diese Funktion erfordert untergeordnete Elemente.This capability requires child elements. Weitere Informationen finden Sie unter So wird's gemacht: Angeben von Gerätefunktionen für Bluetooth.For more info, see How to specify device capabilities for Bluetooth.

BeispieleExamples

Im folgenden finden Sie ein Beispiel für einen Funktions Knoten, 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äte > Elemente analysiert).Here's an example of a Capabilities node that will work on both Windows 10.0.10240.0 and 10.0.10586.0 (although, Windows 10.0.10240.0 will only parse the <Device> elements). Windows 10.0.10586.0 hingegen unterstützt bis zu 100 < Geräte > Elemente plus < F2: Geräte > Elemente für ein Gesamt Komplement von 1000.Windows 10.0.10586.0, on the other hand, supports up to 100 <Device> elements plus <f2:Device> elements for a total complement of 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.If you only want to support Windows 10.0.10240.0, then you only need the <Device> element. Wenn Sie nur Windows 10.0.10586.0 unterstützen möchten, benötigen Sie nur das < F2: Device- > Element.If you only want to support Windows 10.0.10586.0, then you only need the <f2:Device> element.

Weitere Beispiele finden Sie unter Angeben von Gerätefunktionen in einem Paket Manifest.For more examples, see How to specify device capabilities in a package manifest.

Weitere InformationenSee also

Deklarationen von App-FunktionenApp capability declarations

Angeben von Gerätefunktionen in einem PaketmanifestHow to specify device capabilities in a package manifest

Requirements (Anforderungen)Requirements

NamespaceNamespace http://schemas.microsoft.com/appx/manifest/foundation/windows10