Compartilhar via

Objeto Device

O objeto do dispositivo dá suporte às propriedades a seguir. Um aplicativo pode solicitar essas propriedades consultando o objeto raiz (especificando a ID de objeto WPD_DEVICE_OBJECT_ID constante definida). Todos os valores do objeto do 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 Necessário. O valor é WPD_DEVICE_OBJECT_ID.
WPD_OBJECT_PARENT_ID Necessário. O valor é uma cadeia de caracteres vazia.
WPD_OBJECT_NAME Obrigatório se o objeto representa um arquivo.
WPD_OBJECT_PERSISTENT_UNIQUE_ID Necessário.
WPD_OBJECT_ISHIDDEN Necessário se o objeto do dispositivo não deve ser mostrado ao usuário.
WPD_OBJECT_REFERENCES Necessário se o objeto do 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 Necessário.
WPD_DEVICE_POWER_LEVEL Recomendado se o dispositivo tiver uma bateria.
WPD_DEVICE_POWER_SOURCE Recomendado.
WPD_DEVICE_PROTOCOL Recomendado.
WPD_DEVICE_MANUFACTURER Necessário.
WPD_DEVICE_MODEL Necessário.
WPD_DEVICE_SERIAL_NUMBER Necessário.
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 Recomendado.
WPD_DEVICE_SUPPORTED_DRM_SCHEME Recomendado se o dispositivo dá suporte ao DRM (Digital Rights Management).
WPD_DEVICE_SUPPORTED_FORMATS_ARE_ORDERED Recomendado se o dispositivo dá suporte à ordenação de formato preferencial.
WPD_DEVICE_TYPE Recomendado.
WPD_DEVICE_FUNCTIONAL_UNIQUE_ID Opcional.
WPD_DEVICE_MODEL_UNIQUE_ID Opcional.
WPD_DEVICE_TRANSPORT Recomendado.
WPD_DEVICE_USE_DEVICE_STAGE Opcional.
WPD_FUNCTIONAL_OBJECT_CATEGORY Necessário.

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. O que dá suporte a um objeto ou dispositivo depende 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 Commands.

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 mortas, 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 "mensagens de texto". WPD_CATEGORY_SMS
Dispositivos que funcionam como dispositivos de armazenamento. Elas incluem 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

Requisitos de para objetos

  • Last updated on