Propriedades do dispositivo (PortableDevice.h)
Os Dispositivos Portáteis do Windows dão suporte às propriedades do dispositivo a seguir.
| Propriedade | VarType | Descrição |
|---|---|---|
| WPD_DEVICE_DATETIME | VT_DATE | A data e a hora atuais no dispositivo. |
| WPD_DEVICE_FIRMWARE_VERSION | VT_LPWSTR | A versão do firmware do dispositivo. |
| WPD_DEVICE_FUNCTIONAL_UNIQUE_ID | VT_VECTOR | VT_UI1 | Um identificador exclusivo de 16 bytes que é comum em vários transportes compatíveis com o dispositivo. Se um único dispositivo der suporte a vários transportes, essa propriedade poderá ser usada para associar os vários drivers WPD de transporte a esse dispositivo. |
| WPD_DEVICE_MANUFACTURER | VT_LPWSTR | Um nome de fabricante de dispositivo legível por humanos. |
| WPD_DEVICE_MODEL | VT_LPWSTR | O modelo do dispositivo. |
| WPD_DEVICE_MODEL_UNIQUE_ID | VT_VECTOR | VT_UI1 | Um identificador exclusivo de 16 bytes usado para diferenciar entre diferentes modelos de um dispositivo. |
| WPD_DEVICE_NETWORK_IDENTIFIER | VT_UI8 | Um valor que especifica o identificador de rede EUI-64 do dispositivo; essa propriedade é usada para operações de rede fora de banda. Se o dispositivo tiver endereços de rede física MAC-48 (típicos de redes IPv4), o endereço MAC-48 será codificado no endereço EUI-64 como as duas metades do endereço MAC-48 separado por FF-FF. O valor EUI-64 é armazenado na ordem "network" ou "big-endian", em que um endereço EUI-64 de 01-02-03-FF-FF-04-05-06 seria colocado no VT_UI8 de modo que o valor decimal seja 72624942021346566. Essa propriedade é necessária em qualquer dispositivo que dê suporte à Autenticação Nominal ou Segura. Essa propriedade é recomendada em dispositivos que dão suporte apenas à Autenticação Zero. O valor pode ser usado pelo host para estabelecer automaticamente o acesso ao dispositivo sem intervenção do usuário. |
| WPD_DEVICE_POWER_LEVEL | VT_UI4 | Um valor de 0 a 100 que especifica o nível de energia da bateria do dispositivo, sendo 0 nenhum e 100 totalmente carregados. |
| WPD_DEVICE_POWER_SOURCE | VT_UI4 | Uma enumeração WPD_POWER_SOURCES que especifica a fonte de energia do dispositivo. |
| WPD_DEVICE_PROTOCOL | VT_LPWSTR | O protocolo de dispositivo que está sendo usado. |
| WPD_DEVICE_SERIAL_NUMBER | VT_LPWSTR | Número de série do dispositivo. |
| WPD_DEVICE_SUPPORTED_DRM_SCHEMES | VT_UNKNOWN | Um valor que especifica se os formatos com suporte retornados do dispositivo estão em uma ordem preferencial. O primeiro formato na lista é mais preferencial pelo dispositivo, enquanto o último é o menos preferencial. Os aplicativos podem usar essa propriedade para determinar se os formatos com suporte de um dispositivo estão listados em uma ordem preferencial. |
| WPD_DEVICE_SUPPORTED_FORMATS_ARE_ORDERED | VT_BOOL | Um valor booliano que especifica se os formatos com suporte retornados do dispositivo estão em uma ordem preferencial; ou seja, o primeiro formato retornado é mais preferencial, enquanto o último formato retornado é menos preferencial. |
| WPD_DEVICE_SUPPORTS_NON_CONSUMABLE | VT_BOOL | Um valor booliano que especifica se o dispositivo dá suporte a objetos não consumíveis. Esses são objetos que o dispositivo destina-se apenas a armazenar, não reproduzir ou usar de forma alguma. |
| WPD_DEVICE_SYNC_PARTNER | VT_LPWSTR | Uma descrição legível por humanos do parceiro de sincronização de um dispositivo. Esse é um dispositivo, aplicativo ou servidor com o qual o dispositivo se comunica para manter um estado comum ou um grupo de arquivos entre ambos os parceiros. Exemplos incluem programas de email e bibliotecas de música. |
| WPD_DEVICE_FRIENDLY_NAME | VT_LPWSTR | Um valor que representa o nome amigável definido pelo usuário no dispositivo. |
| WPD_DEVICE_TRANSPORT | VT_UI4 | o transporte compatível com o dispositivo, como USB, IP ou Bluetooth. Os valores válidos são do tipo de enumeração WPD_DEVICE_TRANSPORTS . |
| WPD_DEVICE_TYPE | VT_UI4 | Um valor que especifica o tipo de dispositivo; os aplicativos usam essa propriedade apenas para fins de representação. As características funcionais do dispositivo são decididas por meio de objetos funcionais. Dispositivos que não fornecem um ícone de dispositivo, por exemplo, um WPD_RESOURCE_ICON para o objeto de dispositivo, serão representados no Namespace do WPD com um ícone genérico. Esse ícone dependerá do tipo de dispositivo especificado, por exemplo, se o tipo de dispositivo for um telefone celular, o ícone de telefone genérico será usado. Na primeira instalação do dispositivo, o Instalador de Classe WPD consultará esse valor de propriedade e o armazenará no registro do dispositivo sob o valor PORTABLE_DEVICE_TYPE como um REG_DWORD. Os valores possíveis desse parâmetro são da enumeração WPD_DEVICE_TYPES definida em PortableDevice.h. Os valores são:
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 | Se essa propriedade existir e estiver definida como TRUE, o dispositivo poderá ser usado com o Estágio do Dispositivo . Isso se destina a dispositivos que não podem armazenar metadados usando o Serviço de Metadados de Dispositivo, mas fornecerão metadados nos servidores Microsoft. |
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|