Partilhar via

Objeto do dispositivo

O objeto de dispositivo suporta as seguintes propriedades. Um aplicativo pode solicitar essas propriedades consultando o objeto raiz (especificando o ID de objeto definido WPD_DEVICE_OBJECT_ID constante). Todos os valores do objeto device são somente leitura.

Se um determinado dispositivo implementa a categoria WPD_FUNCTIONAL_CATEGORY_DEVICE, ele também deve suportar as 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 representar 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 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 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 Necessário se o dispositivo suportar objetos não consumíveis; ou seja, se ele pode 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 suportar a Gestão de Direitos Digitais (DRM).
WPD_DEVICE_SUPPORTED_FORMATS_ARE_ORDERED Recomendado se o dispositivo suportar pedidos de formato preferido.
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 suportar um conjunto específico de comandos definidos pelos Dispositivos Portáteis do Windows. Os comandos suportados por um objeto ou dispositivo dependem do seu tipo, funcionalidade e capacidades.

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 suportar os comandos para todas as categorias aplicáveis. Por exemplo, um telemóvel com uma câmara enquadrar-se-ia em três categorias: todos os dispositivos, dispositivos SMS e dispositivos de captura de imagem. Um driver personalizado e um aplicativo cliente podem oferecer suporte a comandos ou propriedades adicionais que você define, mas devem oferecer suporte aos seguintes comandos. 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 estáticas, 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 é frequentemente chamado de "mensagens de texto". WPD_CATEGORY_SMS
Dispositivos que funcionam como dispositivos de armazenamento. Estes incluem unidades externas. Se um dispositivo suporta a capacidade de formatar uma loja ou mover objetos de um local para outro, seu driver deve suportar essa categoria.
 WPD_CATEGORY_STORAGE

Requisitos para objetos

  • Last updated on