Objeto Device
O objeto de dispositivo dá suporte às propriedades a seguir. Um aplicativo pode solicitar essas propriedades consultando o objeto raiz (especificando o WPD_DEVICE_OBJECT_ID ID de objeto constante definido). Todos os valores do objeto de dispositivo são somente leitura.
Se um determinado dispositivo implementar a categoria WPD_FUNCTIONAL_CATEGORY_DEVICE , ele também deverá dar suporte às propriedades associadas a essa categoria.
| Nome da propriedade | Obrigatório ou opcional |
|---|---|
| WPD_OBJECT_ID | Obrigatórios. O valor é WPD_DEVICE_OBJECT_ID. |
| WPD_OBJECT_PARENT_ID | Obrigatórios. O valor é uma cadeia de caracteres vazia. |
| WPD_OBJECT_NAME | Obrigatório se o objeto representa um arquivo. |
| WPD_OBJECT_PERSISTENT_UNIQUE_ID | Obrigatórios. |
| WPD_OBJECT_ISHIDDEN | Obrigatório se o objeto do dispositivo não deve ser mostrado ao usuário. |
| WPD_OBJECT_REFERENCES | Obrigatório se o objeto de dispositivo tiver referências a outros objetos. |
| WPD_OBJECT_KEYWORDS | Opcional. |
| WPD_OBJECT_SYNC_ID | Opcional. |
| WPD_OBJECT_GENERATE_THUMBNAIL_FROM_RESOURCE | Opcional. |
| WPD_DEVICE_SYNC_PARTNER | Opcional. |
| WPD_DEVICE_FIRMWARE_VERSION | Obrigatórios. |
| WPD_DEVICE_POWER_LEVEL | Recomendado se o dispositivo tiver uma bateria. |
| WPD_DEVICE_POWER_SOURCE | Recomendável. |
| WPD_DEVICE_PROTOCOL | Recomendável. |
| WPD_DEVICE_MANUFACTURER | Obrigatórios. |
| WPD_DEVICE_MODEL | Obrigatórios. |
| WPD_DEVICE_SERIAL_NUMBER | Obrigatórios. |
| WPD_DEVICE_SUPPORTS_NON_CONSUMABLE | Obrigatório se o dispositivo der suporte a objetos não consumíveis; ou seja, se ele puder ser usado para armazenamento de dados simples. |
| WPD_DEVICE_DATETIME | Opcional. |
| WPD_DEVICE_FRIENDLY_NAME | Recomendável. |
| WPD_DEVICE_SUPPORTED_DRM_SCHEME | Recomendado se o dispositivo der suporte ao DRM (Gerenciamento de Direitos Digitais). |
| WPD_DEVICE_SUPPORTED_FORMATS_ARE_ORDERED | Recomendado se o dispositivo der suporte à ordenação de formato preferencial. |
| WPD_DEVICE_TYPE | Recomendável. |
| WPD_DEVICE_FUNCTIONAL_UNIQUE_ID | Opcional. |
| WPD_DEVICE_MODEL_UNIQUE_ID | Opcional. |
| WPD_DEVICE_TRANSPORT | Recomendável. |
| WPD_DEVICE_USE_DEVICE_STAGE | Opcional. |
| WPD_FUNCTIONAL_OBJECT_CATEGORY | Obrigatórios. |
Recursos típicos
Esses objetos normalmente não hospedam recursos.
Comandos
Além das propriedades, os dispositivos devem dar suporte a um conjunto específico de comandos definidos por Dispositivos Portáteis do Windows. Os comandos aos quais um objeto ou dispositivo dá suporte dependem de seu tipo, funcionalidade e funcionalidades.
A tabela a seguir descreve as classes de comando que se aplicam aos dispositivos, por funcionalidade. Normalmente, um dispositivo se enquadra em várias categorias e deve dar suporte aos comandos para todas as categorias aplicáveis. Por exemplo, um telefone celular com uma câmera se enquadraria em três categorias: todos os dispositivos, dispositivos SMS e dispositivos de captura de imagem. Um driver personalizado e um aplicativo cliente podem dar suporte a comandos ou propriedades adicionais que você definir, mas devem dar suporte aos comandos a seguir. Para obter uma descrição dos comandos específicos que se enquadram em cada categoria de comando, consulte Comandos.
| Descrição | Categorias de comando |
|---|---|
| Todos os dispositivos. |
WPD_CATEGORY_CAPABILITIESWPD_CATEGORY_COMMON WPD_CATEGORY_OBJECT_ENUMERATION WPD_CATEGORY_OBJECT_MANAGEMENT WPD_CATEGORY_OBJECT_PROPERTIES WPD_CATEGORY_OBJECT_PROPERTIES_BULK WPD_CATEGORY_OBJECT_RESOURCES |
| Dispositivos que podem capturar imagens paradas, como câmeras digitais. | WPD_CATEGORY_STILL_IMAGE_CAPTURE |
| Dispositivos que podem enviar mensagens SMS (serviço de mensagens curtas), como telefones celulares. O envio de mensagens SMS geralmente é chamado de "mensagem de texto". | WPD_CATEGORY_SMS |
| Dispositivos que funcionam como dispositivos de armazenamento. Isso inclui unidades externas. Se um dispositivo der suporte à capacidade de formatar um repositório ou mover objetos de um local para outro, o driver deverá dar suporte a essa categoria. |
WPD_CATEGORY_STORAGE |