DeviceCapability (Windows 10)

Artículo
02/01/2024

Declara una funcionalidad de dispositivo requerida por un paquete. En Windows 10.0.10240.0, puede contener hasta 100 elementos Device. En Windows 10.0.10586.0, puede contener hasta 1000 (para obtener sintaxis y ejemplos, vea Ejemplos).

Jerarquía de elemento

<DeviceCapability>

Sintaxis

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

Clave

{} intervalo específico de repeticiones

Atributos y elementos

Atributos

Atributo	Descripción	Tipo de datos	Obligatorio	Valor predeterminado
Nombre	El nombre de la funcionalidad del dispositivo, ya sea especificado como un nombre descriptivo o un GUID de clase de interfaz de dispositivo.	Cadena con un valor entre 1 y 50 caracteres de longitud o un GUID con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxx.	Sí

Elementos secundarios

Elemento secundario	Descripción
Dispositivo	Declara una función para un dispositivo asociado a DeviceCapability. En Windows 10.0.10240.0, DeviceCapability puede contener hasta 100 elementos Device. En Windows 10.0.10586.0, puede contener hasta 1000 (para obtener más detalles, consulta DeviceCapability).

Elementos primarios

Elemento primario	Descripción
Capabilities	Declara el acceso a los recursos de usuario protegidos que requiere el paquete. Puede tener varios elementos DeviceCapability y Capability en el elemento Capabilities , pero todos los elementos DeviceCapability deben aparecer después de los elementos Capability .

Observaciones

Si el atributo Name se especifica como GUID, se valida como GUID.

De forma predeterminada, a algunas aplicaciones se les concede acceso a algunos dispositivos. Para acceder a otros tipos de dispositivos, debe especificarlos mediante un elemento DeviceCapability . Algunas funcionalidades del dispositivo se deben agregar manualmente al manifiesto del paquete. Para más información, consulta Cómo especificar funcionalidades de dispositivos en un manifiesto del paquete.

Para obtener más información sobre las declaraciones de funcionalidad, consulta Declaraciones de funcionalidad de la aplicación.

Las siguientes funcionalidades de dispositivo requieren elementos secundarios.

Funcionalidad del dispositivo	Descripción
Usb	Proporciona acceso a las API del espacio de nombres Windows.Devices.Usb . Esta capacidad requiere elementos secundarios. Para obtener más información, consulta Actualización del paquete de manifiesto de la aplicación para un dispositivo USB.
humaninterfacedevice	Proporciona acceso a las API del espacio de nombres Windows.Devices.HumanInterfaceDevice . Esta capacidad requiere elementos secundarios. Para más información, consulta Cómo especificar funcionalidades de dispositivos para HID.
bluetooth.genericAttributeProfile	Proporciona acceso a las API en el espacio de nombres Windows.Devices.Bluetooth.GenericAttributeProfile . Esta capacidad requiere elementos secundarios. Para más información, consulta Cómo especificar funcionalidades de dispositivos para Bluetooth.
bluetooth.rfcomm	Proporciona acceso a las API en el espacio de nombres Windows.Devices.Bluetooth.Rfcomm . Esta capacidad requiere elementos secundarios. Para más información, consulta Cómo especificar funcionalidades de dispositivos para Bluetooth.

Ejemplos

Este es un ejemplo de un nodo Capabilities que funcionará en Windows 10.0.10240.0 y 10.0.10586.0 (aunque, Windows 10.0.10240.0 solo analizará los <elementos Device>). Windows 10.0.10586.0, por otro lado, admite hasta 100 < Elementos del dispositivo> más <f2:Elementos de dispositivo> para un 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>

Si solo quieres admitir Windows 10.0.10240.0, solo necesitas el <elemento Device>. Si solo quieres admitir Windows 10.0.10586.0, solo necesitas el <elemento f2:Device>.

Para obtener más ejemplos, consulte Cómo especificar las funcionalidades del dispositivo en un manifiesto de paquete.

Vea también

Declaraciones de funcionalidades de las aplicaciones

Cómo especificar funcionalidades de dispositivo en un manifiesto del paquete

Requisitos

Elemento	Value
Espacio de nombres	`http://schemas.microsoft.com/appx/manifest/foundation/windows10`

Compartir a través de