DeviceCapability (Windows 10)

声明包所需的设备功能。 在 Windows 10.0.10240.0 上，最多可以包含 100 个设备元素。 在 Windows 10.0.10586.0 上，语法和示例最多可以包含 1000 (，请参阅示例) 。

元素层次结构

<程序包>

    <功能>

         <DeviceCapability>

语法

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

密钥

{} 特定出现的范围

特性和元素

属性

特性	说明	数据类型	必须	默认值
名称	设备功能的名称，指定为友好名称或设备接口类 GUID。	长度介于 1 到 50 个字符之间的字符串，或格式为 xxxxxxxx-xxxx-xxxx-xxxx-xxx 的 GUID。	是

子元素

子元素	描述
设备	声明与 DeviceCapability 关联的设备的函数。 在 Windows 10.0.10240.0 上，DeviceCapability 最多可以包含 100 个设备元素。 在 Windows 10.0.10586.0 上，它可以包含最多 1000 个 (以获取更多详细信息，请参阅 DeviceCapability) 。

父元素

父元素	描述
功能	声明对包所需的受保护用户资源的访问权限。 可以在 Capabilities 元素中具有多个 DeviceCapability 和 Capability 元素，但所有 DeviceCapability 元素必须位于功能元素之后。

注解

如果 Name 属性指定为 GUID，则会将其验证为 GUID。

默认情况下，应用有权访问某些设备。 若要访问其他类型的设备，必须使用 DeviceCapability 元素指定它们。 必须手动将某些设备功能添加到包清单。 有关详细信息，请参阅如何在程序包清单中指定设备功能。

有关功能声明的详细信息，请参阅 应用功能声明。

以下设备功能需要子元素。

设备功能	说明
Usb	提供对 Windows.Devices.Usb 命名空间中的 API 的访问。 此功能需要子元素。 有关详细信息，请参阅 更新 USB 设备的应用清单包。
humaninterfacedevice	提供对 Windows.Devices.HumanInterfaceDevice 命名空间中的 API 的访问。 此功能需要子元素。 有关详细信息，请参阅如何为 HID 指定设备功能。
bluetooth.genericAttributeProfile	提供对 Windows.Devices.Bluetooth.GenericAttributeProfile 命名空间中的 API 的访问。 此功能需要子元素。 有关详细信息，请参阅如何为蓝牙指定设备功能。
bluetooth.rfcomm	提供对 Windows.Devices.Bluetooth.Rfcomm 命名空间中的 API 的访问。 此功能需要子元素。 有关详细信息，请参阅如何为蓝牙指定设备功能。

示例

下面是一个功能节点的示例，该节点可同时处理 Windows 10.0.10240.0 和 10.0.10586.0 (，不过，Windows 10.0.10240.0 只会分析<设备>元素) 。 另一方面，Windows 10.0.10586.0 支持最多 100 < 个设备>元素加上 <f2：Device> 元素，总补数为 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>

如果只想支持 Windows 10.0.10240.0，则只需要 <Device> 元素。 如果只想支持 Windows 10.0.10586.0，则只需要 <f2：Device> 元素。

有关更多示例，请参阅 如何在包清单中指定设备功能。

另请参阅

应用功能声明

如何在程序包清单中指定设备功能

要求

项	值
Namespace	http://schemas.microsoft.com/appx/manifest/foundation/windows10