Propiedades del dispositivo (PortableDevice.h)
Dispositivos portátiles de Windows admite las siguientes propiedades de dispositivo.
| Propiedad | VarType | Descripción |
|---|---|---|
| WPD_DEVICE_DATETIME | VT_DATE | Fecha y hora actuales en el dispositivo. |
| WPD_DEVICE_FIRMWARE_VERSION | VT_LPWSTR | La versión del firmware del dispositivo. |
| WPD_DEVICE_FUNCTIONAL_UNIQUE_ID | VT_VECTOR | VT_UI1 | Identificador único de 16 bytes que es común en varios transportes admitidos por el dispositivo. Si un único dispositivo admite varios transportes, esta propiedad se puede usar para asociar los distintos controladores wpD de transporte con ese dispositivo. |
| WPD_DEVICE_MANUFACTURER | VT_LPWSTR | Nombre del fabricante de un dispositivo legible. |
| WPD_DEVICE_MODEL | VT_LPWSTR | El modelo del dispositivo. |
| WPD_DEVICE_MODEL_UNIQUE_ID | VT_VECTOR | VT_UI1 | Identificador único de 16 bytes que se usa para diferenciar entre diferentes modelos de un dispositivo. |
| WPD_DEVICE_NETWORK_IDENTIFIER | VT_UI8 | Valor que especifica el identificador de red EUI-64 del dispositivo; esta propiedad se usa para las operaciones de red fuera de banda. Si el dispositivo tiene direcciones de red físicas MAC-48 (típicas de redes IPv4), la dirección MAC-48 se codifica en la dirección EUI-64 como las dos mitades de la dirección MAC-48 separadas por FF-FF. El valor EUI-64 se almacena en orden "network" o "big-endian", donde una dirección EUI-64 de 01-02-03-FF-FF-04-05-06 se colocaría en el VT_UI8 de modo que el valor decimal sea 72624942021346566. Esta propiedad es necesaria en cualquier dispositivo que admita la autenticación nominal o segura. Esta propiedad se recomienda en los dispositivos que solo admiten la autenticación cero. El host puede usar el valor para establecer automáticamente el acceso al dispositivo sin intervención del usuario. |
| WPD_DEVICE_POWER_LEVEL | VT_UI4 | Valor comprendido entre 0 y 100 que especifica el nivel de potencia de la batería del dispositivo, con 0 siendo ninguno y 100 cargados por completo. |
| WPD_DEVICE_POWER_SOURCE | VT_UI4 | Enumeración WPD_POWER_SOURCES que especifica la fuente de alimentación del dispositivo. |
| WPD_DEVICE_PROTOCOL | VT_LPWSTR | Protocolo de dispositivo que se está usando. |
| WPD_DEVICE_SERIAL_NUMBER | VT_LPWSTR | El número de serie del dispositivo. |
| WPD_DEVICE_SUPPORTED_DRM_SCHEMES | VT_UNKNOWN | Valor que especifica si los formatos admitidos devueltos desde el dispositivo están en un orden preferido. El primer formato de la lista es el preferido por el dispositivo, mientras que el último es el menos preferido. Las aplicaciones pueden usar esta propiedad para determinar si los formatos admitidos de un dispositivo se muestran en un orden preferido. |
| WPD_DEVICE_SUPPORTED_FORMATS_ARE_ORDERED | VT_BOOL | Valor booleano que especifica si los formatos admitidos devueltos por el dispositivo están en un orden preferido; es decir, se prefiere el primer formato devuelto, mientras que el último formato devuelto es el menos preferido. |
| WPD_DEVICE_SUPPORTS_NON_CONSUMABLE | VT_BOOL | Valor booleano que especifica si el dispositivo admite objetos no consumibles. Estos son objetos que el dispositivo solo está pensado para almacenar, no reproducir ni usar de ninguna manera. |
| WPD_DEVICE_SYNC_PARTNER | VT_LPWSTR | Descripción legible del asociado de sincronización de un dispositivo. Se trata de un dispositivo, una aplicación o un servidor con el que el dispositivo se comunica para mantener un estado común o un grupo de archivos entre ambos asociados. Entre los ejemplos se incluyen programas de correo electrónico y bibliotecas de música. |
| WPD_DEVICE_FRIENDLY_NAME | VT_LPWSTR | Valor que representa el nombre descriptivo establecido por el usuario en el dispositivo. |
| WPD_DEVICE_TRANSPORT | VT_UI4 | el transporte compatible con el dispositivo, como USB, IP o Bluetooth. Los valores válidos son del tipo de enumeración WPD_DEVICE_TRANSPORTS . |
| WPD_DEVICE_TYPE | VT_UI4 | Valor que especifica el tipo de dispositivo; Las aplicaciones usan esta propiedad únicamente con fines de representación. Las características funcionales del dispositivo se deciden mediante objetos funcionales. Los dispositivos que no proporcionan un icono de dispositivo, por ejemplo, un WPD_RESOURCE_ICON para el objeto de dispositivo, se representarán en el espacio de nombres de WPD con un icono genérico. Este icono dependerá del tipo de dispositivo especificado, por ejemplo, si el tipo de dispositivo es un teléfono móvil, se usa el icono de teléfono genérico. En la primera instalación del dispositivo, el Instalador de clase wpD consultará este valor de propiedad y lo almacenará en el registro de dispositivos en el valor de PORTABLE_DEVICE_TYPE como un REG_DWORD. Los valores posibles de este parámetro proceden de la enumeración WPD_DEVICE_TYPES definida en PortableDevice.h. Los valores son:
WPD_DEVICE_TYPE_CAMERA WPD_DEVICE_TYPE_MEDIA_PLAYER WPD_DEVICE_TYPE_PHONE WPD_DEVICE_TYPE_VIDEO WPD_DEVICE_TYPE_PERSONAL_INFORMATION_MANAGER WPD_DEVICE_TYPE_AUDIO_RECORDER |
| WPD_DEVICE_USE_DEVICE_STAGE | VT_BOOL | Si esta propiedad existe y se establece en TRUE, el dispositivo se puede usar con Device Stage . Esto está pensado para dispositivos que no pueden almacenar metadatos mediante el Servicio de metadatos de dispositivo, pero proporcionarán metadatos en los servidores de Microsoft. |
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|