DeviceCapability (Windows 10)DeviceCapability (Windows 10)

Déclare une fonctionnalité de périphérique requise par un package.Declares a device capability required by a package. Sur Windows 10.0.10240.0, peut contenir jusqu’à 100 éléments d' appareil .On Windows 10.0.10240.0, can contain up to 100 Device elements. Sur Windows 10.0.10586.0, peut contenir jusqu’à 1000 (pour la syntaxe et des exemples, consultez Exemples).On Windows 10.0.10586.0, can contain up to 1000 (for syntax and examples, see Examples).

Hiérarchie d’élémentsElement hierarchy

<Packages>
<Package>
<Possibilités>
<Capabilities>
<DeviceCapability><DeviceCapability>

SyntaxeSyntax

<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>

CléKey

{}  plage spécifique d’occurrences{}   specific range of occurrences

Attributs et élémentsAttributes and Elements

AttributsAttributes

AttributAttribute DescriptionDescription Type de donnéesData type ObligatoireRequired Valeur par défautDefault value
NomName

Nom de la fonctionnalité de l’appareil, spécifié sous la forme d’un nom convivial ou d’un GUID de classe d’interface d’appareil.The name of the device capability, either specified as a friendly name or a device interface class GUID.

Chaîne d’une longueur de 1 à 50 caractères ou d’un GUID au format 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. OuiYes

 

Éléments enfantsChild Elements

Élément enfantChild Element DescriptionDescription
Passerelle Device

Déclare une fonction pour un appareil qui est associé à DeviceCapability .Declares a function for a device that is associated with the DeviceCapability . Sur Windows 10.0.10240.0, un DeviceCapability peut contenir jusqu’à 100 éléments d' appareil .On Windows 10.0.10240.0, a DeviceCapability can contain up to 100 Device elements. Sur Windows 10.0.10586.0, il peut contenir jusqu’à 1000 (pour plus d’informations, consultez DeviceCapability).On Windows 10.0.10586.0, it can contain up to 1000 (for more details, see DeviceCapability).

 

Éléments parentsParent Elements

Élément parentParent Element DescriptionDescription
Possibilités Capabilities

Déclare l’accès aux ressources utilisateur protégées requises par le package.Declares the access to protected user resources that the package requires. Vous pouvez avoir plusieurs éléments DeviceCapability et Capability dans l’élément Capabilities , mais tous les éléments DeviceCapability doivent être placés après les éléments de fonctionnalité .You can have multiple DeviceCapability and Capability elements in the Capabilities element, but all DeviceCapability elements must come after the Capability elements.

 

Notes Remarks

Si l’attribut Name est spécifié en tant que GUID, il est validé en tant que GUID.If the Name attribute is specified as a GUID, then it is validated as GUID.

Par défaut, les applications sont autorisées à accéder à certains appareils.Apps are granted access to some devices by default. Pour accéder à d’autres types d’appareils, vous devez les spécifier à l’aide d’un élément DeviceCapability .To access other types of devices, you must specify them using a DeviceCapability element. Certaines fonctionnalités de l’appareil doivent être ajoutées manuellement au manifeste du package.Some device capabilities must be added to the package manifest manually. Pour plus d’informations, voir Comment spécifier des fonctionnalités de périphérique dans un manifeste de package.For more info, see How to specify device capabilities in a package manifest.

Pour plus d’informations sur les déclarations de fonctionnalité, consultez déclarations de fonctionnalités d’application.For more info about capability declarations, see App capability declarations.

Les fonctionnalités d’appareil suivantes requièrent des éléments enfants.The following device capabilities require child elements.

Fonctionnalité d’appareilDevice capability DescriptionDescription
portsusb Permet d’accéder aux API de l’espace de noms Windows. Devices. USB .Provides access to APIs in the Windows.Devices.Usb namespace. Cette fonctionnalité nécessite des éléments enfants.This capability requires child elements. Pour plus d’informations, consultez mise à jour du package du manifeste d’application pour un périphérique USB.For more info, see Updating the app manifest package for a USB device.
humaninterfacedevicehumaninterfacedevice Permet d’accéder aux API de l’espace de noms Windows. Devices. HumanInterfaceDevice .Provides access to APIs in the Windows.Devices.HumanInterfaceDevice namespace. Cette fonctionnalité nécessite des éléments enfants.This capability requires child elements. Pour plus d’informations, voir Comment spécifier des fonctionnalités de périphérique pour un périphérique d’interface utilisateur (HID).For more info, see How to specify device capabilities for HID.
Bluetooth. genericAttributeProfilebluetooth.genericAttributeProfile Permet d’accéder aux API de l’espace de noms Windows. Devices. Bluetooth. GenericAttributeProfile .Provides access to APIs in the Windows.Devices.Bluetooth.GenericAttributeProfile namespace. Cette fonctionnalité nécessite des éléments enfants.This capability requires child elements. Pour plus d’informations, voir Comment spécifier des fonctionnalités de périphérique pour Bluetooth.For more info, see How to specify device capabilities for Bluetooth.
Bluetooth. RFCOMMbluetooth.rfcomm Permet d’accéder aux API de l’espace de noms Windows. Devices. Bluetooth. RFCOMM .Provides access to APIs in the Windows.Devices.Bluetooth.Rfcomm namespace. Cette fonctionnalité nécessite des éléments enfants.This capability requires child elements. Pour plus d’informations, voir Comment spécifier des fonctionnalités de périphérique pour Bluetooth.For more info, see How to specify device capabilities for Bluetooth.

 

ExemplesExamples

Voici un exemple de nœud de fonctionnalités qui fonctionnera à la fois sur Windows 10.0.10240.0 et 10.0.10586.0 (même si, Windows 10.0.10240.0 n’analyse <que> les éléments d’appareil).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, en revanche, prend en charge jusqu’à 100 <éléments> d’appareil <et les éléments> f2 : Device pour un complément total de 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>

Si vous souhaitez uniquement prendre en charge Windows 10.0.10240.0, vous avez uniquement besoin <de> l’élément Device.If you only want to support Windows 10.0.10240.0, then you only need the <Device> element. Si vous souhaitez uniquement prendre en charge Windows 10.0.10586.0, vous avez uniquement besoin <de l’élément> F2 : Device.If you only want to support Windows 10.0.10586.0, then you only need the <f2:Device> element.

Pour obtenir plus d’exemples, consultez comment spécifier des fonctionnalités d’appareil dans un manifeste de package.For more examples, see How to specify device capabilities in a package manifest.

Voir aussiSee also

Déclarations des fonctionnalités d’applicationApp capability declarations

Comment spécifier des fonctionnalités de périphérique dans un manifeste de packageHow to specify device capabilities in a package manifest

SpécificationsRequirements

Espace de nomsNamespace http://schemas.microsoft.com/appx/manifest/foundation/windows10