DeviceCapability (Windows 10)

Article
02/01/2024

Déclare une fonctionnalité d’appareil requise par un package. Sur Windows 10.0.10240.0, peut contenir jusqu’à 100 éléments d’appareil. Sur Windows 10.0.10586.0, peut contenir jusqu’à 1 000 (pour obtenir une syntaxe et des exemples, voir Exemples).

Hiérarchie d’éléments

<Fonctionnalités>

<DeviceCapability>

Syntaxe

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

Clé

{} plage spécifique d’occurrences

Attributs et éléments

Attributs

Attribut	Description	Type de données	Obligatoire	Valeur par défaut
Nom	Nom de la fonctionnalité d’appareil, spécifié sous la forme d’un nom convivial ou d’un GUID de classe d’interface d’appareil.	Chaîne dont la valeur est comprise entre 1 et 50 caractères ou un GUID sous la forme xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxx.	Oui

Éléments enfants

Élément enfant	Description
Appareil	Déclare une fonction pour un appareil associé à DeviceCapability. Sur Windows 10.0.10240.0, un DeviceCapability peut contenir jusqu’à 100 éléments Device. Sur Windows 10.0.10586.0, il peut contenir jusqu’à 1 000 (pour plus d’informations, voir DeviceCapability).

Éléments parents

Élément parent	Description
Capabilities	Déclare l’accès aux ressources utilisateur protégées requises par le package. Vous pouvez avoir plusieurs éléments DeviceCapability et Capability dans l’élément Capabilities , mais tous les éléments DeviceCapability doivent venir après les éléments De fonctionnalité .

Remarques

Si l’attribut Name est spécifié en tant que GUID, il est validé en tant que GUID.

Les applications sont autorisées à accéder à certains appareils par défaut. Pour accéder à d’autres types d’appareils, vous devez les spécifier à l’aide d’un élément DeviceCapability . Certaines fonctionnalités d’appareil doivent être ajoutées manuellement au manifeste du package. Pour plus d’informations, voir Comment spécifier des fonctionnalités de périphérique dans un manifeste de package.

Pour plus d’informations sur les déclarations de fonctionnalités, consultez déclarations de capacité d’application.

Les fonctionnalités d’appareil suivantes nécessitent des éléments enfants.

Fonctionnalité d’appareil	Description
Usb	Fournit l’accès aux API dans l’espace de noms Windows.Devices.Usb . Cette fonctionnalité nécessite des éléments enfants. Pour plus d’informations, consultez Mise à jour du package de manifeste d’application pour un périphérique USB.
humaninterfacedevice	Fournit l’accès aux API dans l’espace de noms Windows.Devices.HumanInterfaceDevice . Cette fonctionnalité nécessite des éléments enfants. Pour plus d’informations, voir Comment spécifier des fonctionnalités de périphérique pour un périphérique d’interface utilisateur (HID).
bluetooth.genericAttributeProfile	Fournit l’accès aux API dans l’espace de noms Windows.Devices.Bluetooth.GenericAttributeProfile . Cette fonctionnalité nécessite des éléments enfants. Pour plus d’informations, voir Comment spécifier des fonctionnalités de périphérique pour Bluetooth.
bluetooth.rfcomm	Fournit l’accès aux API dans l’espace de noms Windows.Devices.Bluetooth.Rfcomm . Cette fonctionnalité nécessite des éléments enfants. Pour plus d’informations, voir Comment spécifier des fonctionnalités de périphérique pour Bluetooth.

Exemples

Voici un exemple de nœud Fonctionnalités qui fonctionnera à la fois sur Windows 10.0.10240.0 et 10.0.10586.0 (bien que Windows 10.0.10240.0 analyse uniquement les éléments de l’appareil<>). Windows 10.0.10586.0, en revanche, prend en charge jusqu’à 100 < Éléments d’appareil> et <éléments f2:Device> pour un complément total de 1 000.

<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>. Si vous souhaitez uniquement prendre en charge Windows 10.0.10586.0, vous n’avez besoin que de l’élément <f2:Device>.

Pour plus d’exemples, consultez Comment spécifier des fonctionnalités d’appareil dans un manifeste de package.

Voir aussi

Déclarations des fonctionnalités d’application

Spécifier des fonctionnalités d'appareil dans le manifeste d'un package

Spécifications

Élément	Valeur
Espace de noms	`http://schemas.microsoft.com/appx/manifest/foundation/windows10`

Partager via