DeviceCapability (Windows 10)

  • [アーティクル]

パッケージに必要なデバイス機能を宣言します。 Windows 10.0.10240.0 では、最大 100 個のデバイス要素を含めることができます。 Windows 10.0.10586.0 では、最大 1000 個を含めることができます (構文と例については、例を参照してください)。

要素の階層

<Package>

    <機能>

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

Key

{} 特定の出現範囲

属性と要素

属性

属性 説明 データ型 必須 既定値
名前 フレンドリ名またはデバイス インターフェイス クラス GUID として指定されたデバイス機能の名前。 長さが 1 ~ 50 文字の文字列、または xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx という形式の GUID。 はい

子要素

子要素 説明
[デバイス] DeviceCapability に関連付けられているデバイスの関数を宣言します。 Windows 10.0.10240.0 では、DeviceCapability には最大 100 個のデバイス要素を含めることができます。 Windows 10.0.10586.0 では、最大 1000 個を含めることができます (詳細については、DeviceCapability を参照してください)。

親要素

親要素 説明
Capabilities パッケージに必要な保護されたユーザー リソースへのアクセスを宣言します。 Capabilities 要素には複数の DeviceCapability 要素と Capability 要素を含めることができますが、すべての DeviceCapability 要素は Capability 要素の後に含まれている必要があります。

注釈

Name 属性が GUID として指定されている場合は、GUID として検証されます。

アプリには、既定で一部のデバイスへのアクセスが許可されます。 他の種類のデバイスにアクセスするには、 DeviceCapability 要素を使用してデバイスを指定する必要があります。 一部のデバイス機能は、パッケージ マニフェストに手動で追加する必要があります。 詳しくは、「パッケージ マニフェストでデバイス機能を指定する方法」をご覧ください。

機能宣言の詳細については、「 アプリの機能宣言」を参照してください。

次のデバイス機能には、子要素が必要です。

デバイス機能 [説明]
Usb Windows.Devices.Usb 名前空間の API へのアクセスを提供します。 この機能を使うには、子要素が必要です。 詳細については、「 USB デバイスのアプリ マニフェスト パッケージの更新」を参照してください。
humaninterfacedevice Windows.Devices.HumanInterfaceDevice 名前空間内の API へのアクセスを提供します。 この機能を使うには、子要素が必要です。 詳しくは、「HID のデバイス機能を指定する方法」をご覧ください。
bluetooth.genericAttributeProfile Windows.Devices.Bluetooth.GenericAttributeProfile 名前空間の API へのアクセスを提供します。 この機能を使うには、子要素が必要です。 詳しくは、「Bluetooth のデバイス機能を指定する方法」をご覧ください。
bluetooth.rfcomm Windows.Devices.Bluetooth.Rfcomm 名前空間の API へのアクセスを提供します。 この機能を使うには、子要素が必要です。 詳しくは、「Bluetooth のデバイス機能を指定する方法」をご覧ください。

例

Windows 10.0.10240.0 と 10.0.10586.0 の両方で動作する Capabilities ノードの例を次に示します (ただし、Windows 10.0.10240.0 ではデバイス>要素のみが解析<されます)。 一方、Windows 10.0.10586.0 は最大 100 < をサポートします。合計補数 1000 のデバイス>要素と <f2:Device> 要素。

<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