DeviceCapability (Windows 10)

Declara uma funcionalidade de dispositivo exigida por um pacote. No Windows 10.0.10240.0, pode conter até 100 elementos do dispositivo. No Windows 10.0.10586.0, pode conter até 1000 (para sintaxe e exemplos, consulte Exemplos).

Hierarquia de elementos

<Pacote>

    <Funcionalidades>

         <DeviceCapability>

Sintaxe

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

Chave

{} intervalo específico de ocorrências

Atributos e elementos

Atributos

Atributo	Descrição	Tipo de dados	Obrigatório	Valor padrão
Nome	O nome da funcionalidade do dispositivo, especificado como um nome amigável ou um GUID de classe de interface do dispositivo.	Uma cadeia de caracteres com um valor entre 1 e 50 caracteres de comprimento ou um GUID no formulário xxxxxxx-xxxx-xxxx-xxxx-xxxxxxx.	Sim

Elementos filho

Elemento filho	Descrição
Dispositivo	Declara uma função para um dispositivo associado à DeviceCapability. No Windows 10.0.10240.0, um DeviceCapability pode conter até 100 elementos de dispositivo. No Windows 10.0.10586.0, ele pode conter até 1000 (para obter mais detalhes, consulte DeviceCapability).

Elementos pai

Elemento pai	Descrição
Funcionalidades	Declara o acesso aos recursos de usuário protegidos que o pacote requer. Você pode ter vários elementos DeviceCapability e Capability no elemento Capabilities, mas todos os elementosDeviceCapability devem vir após os elementos capability .

Comentários

Se o atributo Name for especificado como GUID, ele será validado como GUID.

Os aplicativos recebem acesso a alguns dispositivos por padrão. Para acessar outros tipos de dispositivos, você deve especificá-los usando um elemento DeviceCapability . Alguns recursos de dispositivo devem ser adicionados ao manifesto do pacote manualmente. Para obter mais informações, consulte Como especificar funcionalidades do dispositivo em um manifesto do pacote.

Para obter mais informações sobre declarações de funcionalidade, consulte declarações de funcionalidade do aplicativo.

Os recursos de dispositivo a seguir exigem elementos filho.

Funcionalidade do dispositivo	Descrição
Usb	Fornece acesso a APIs no namespace Windows.Devices.Usb . Essa funcionalidade pede elementos filho. Para obter mais informações, consulte Atualizando o pacote de manifesto do aplicativo para um dispositivo USB.
humaninterfacedevice	Fornece acesso a APIs no namespace Windows.Devices.HumanInterfaceDevice . Essa funcionalidade pede elementos filho. Para obter mais informações, consulte Como especificar funcionalidades do dispositivo em HID.
bluetooth.genericAttributeProfile	Fornece acesso a APIs no namespace Windows.Devices.Bluetooth.GenericAttributeProfile . Essa funcionalidade pede elementos filho. Para obter mais informações, consulte Como especificar funcionalidades do dispositivo para Bluetooth.
bluetooth.rfcomm	Fornece acesso a APIs no namespace Windows.Devices.Bluetooth.Rfcomm . Essa funcionalidade pede elementos filho. Para obter mais informações, consulte Como especificar funcionalidades do dispositivo para Bluetooth.

Exemplos

Aqui está um exemplo de um nó capabilities que funcionará em Windows 10.0.10240.0 e 10.0.10586.0 (embora, Windows 10.0.10240.0 analisará apenas os elementos do <Dispositivo>). Windows 10.0.10586.0, por outro lado, dá suporte a até 100 < Elementos do dispositivo> mais <f2:Elementos de dispositivo> para um complemento total de 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>

Se você quiser dar suporte apenas ao Windows 10.0.10240.0, só precisará do <elemento Device>. Se você quiser dar suporte apenas ao Windows 10.0.10586.0, só precisará do <elemento f2:Device>.

Para obter mais exemplos, consulte Como especificar os recursos do dispositivo em um manifesto de pacote.

Confira também

Declarações de funcionalidades do aplicativo

Como especificar as funcionalidades do dispositivo em um manifesto do pacote

Requisitos

Item	Valor
Namespace	http://schemas.microsoft.com/appx/manifest/foundation/windows10