Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Um objeto que descreve seu tipo como WPD_CONTENT_FUNCTIONAL_OBJECT representa um objeto funcional, encapsulando a funcionalidade do dispositivo.
Todos os objetos funcionais, independentemente do tipo, suportam as seguintes propriedades. (Se você definir um objeto funcional personalizado, ele também deverá oferecer suporte a essas propriedades.)
| Nome da propriedade | Obrigatório ou Opcional |
|---|---|
| WPD_OBJECT_ID | Obrigatório, somente leitura. Um cliente não pode definir essa propriedade, mesmo no momento da criação. |
| WPD_OBJECT_PARENT_ID | Necessário. |
| WPD_OBJECT_NAME | Necessário. |
| WPD_OBJECT_PERSISTENT_UNIQUE_ID | Obrigatório, somente leitura. Um cliente não pode definir essa propriedade, mesmo no momento da criação. |
| WPD_OBJECT_FORMAT | Necessário. |
| WPD_OBJECT_CONTENT_TYPE | Necessário. |
| WPD_OBJECT_ISHIDDEN | Obrigatório se o objeto estiver oculto. |
| WPD_OBJECT_ISSYSTEM | Necessário se o objeto for um objeto do sistema (representa um arquivo do sistema). |
| WPD_OBJECT_SIZE | Obrigatório se o objeto tiver pelo menos um recurso. |
| WPD_OBJECT_ORIGINAL_FILE_NAME | Obrigatório se o objeto representar um arquivo. |
| WPD_OBJECT_NON_CONSUMABLE | Recomendado se o objeto não se destinar ao consumo pelo dispositivo. |
| WPD_OBJECT_REFERENCES | Obrigatório se o objeto tiver referências a outros objetos. |
| WPD_OBJECT_KEYWORDS | Opcional. |
| WPD_OBJECT_SYNC_ID | Opcional. |
| WPD_OBJECT_IS_DRM_PROTECTED | Necessário se o objeto estiver protegido pela tecnologia DRM. |
| WPD_OBJECT_DATE_CREATED | Opcional. |
| WPD_OBJECT_DATE_MODIFIED | Recomendado. |
| WPD_OBJECT_DATE_AUTHORED | Opcional. |
| WPD_OBJECT_BACK_REFERENCES | Recomendado se o objeto for referenciado por outro objeto. |
| WPD_OBJECT_CONTAINER_FUNCTIONAL_OBJECT_ID | Opcional. |
| WPD_OBJECT_GENERATE_THUMBNAIL_FROM_RESOURCE | Opcional. |
| WPD_OBJECT_CAN_DELETE | Obrigatório se o objeto não puder ser excluído. |
| WPD_OBJECT_LANGUAGE_LOCALE | Opcional. |
| WPD_FUNCTIONAL_OBJECT_CATEGORY | Necessário. Consulte a tabela a seguir para obter as categorias definidas pelos Dispositivos Portáteis do Windows. |
Recursos típicos
Esses objetos normalmente não hospedam recursos.
Categorias de objetos funcionais
Os objetos funcionais podem ser agrupados em categorias, dependendo de suas funções. Uma categoria é descrita pela propriedade WPD_FUNCTIONAL_OBJECT_CATEGORY (um valor GUID). A categoria determina quais propriedades adicionais são suportadas.
A tabela a seguir descreve as categorias definidas pelos Dispositivos Portáteis do Windows. Consulte a descrição da categoria para saber quais propriedades e recursos adicionais o objeto suporta.
| Categoria funcional | Descrição |
|---|---|
| WPD_FUNCTIONAL_CATEGORY_ALL | Esta categoria funcional é válida apenas como um parâmetro para determinadas funções de consulta (para indicar que todos os tipos de objeto funcional são aceitáveis) e não é uma categoria funcional relatada pelo driver. |
| WPD_FUNCTIONAL_CATEGORY_AUDIO_CAPTURE | O objeto encapsula a funcionalidade de captura de áudio no dispositivo, por exemplo, um gravador de voz ou outro componente de gravação de áudio. |
| WPD_FUNCTIONAL_CATEGORY_DEVICE | O objeto encapsula o dispositivo (ou seja, o objeto mais alto do dispositivo). |
| WPD_FUNCTIONAL_CATEGORY_NETWORK_CONFIGURATION | O objeto encapsula a funcionalidade de configuração de rede para o dispositivo, por exemplo, perfis WiFi ou parcerias. |
| WPD_FUNCTIONAL_CATEGORY_RENDERING_INFORMATION | O objeto descreve os tipos de arquivos de mídia que o dispositivo é capaz de reproduzir. |
| WPD_FUNCTIONAL_CATEGORY_SMS | O objeto encapsula a funcionalidade de serviço de mensagens curtas (comumente chamado de "mensagens de texto") no dispositivo. |
| WPD_FUNCTIONAL_CATEGORY_STILL_IMAGE_CAPTURE | O objeto encapsula a funcionalidade de captura de imagem estática em um dispositivo, como uma câmera ou um acessório de câmera. |
| WPD_FUNCTIONAL_CATEGORY_STORAGE | O objeto encapsula o armazenamento de arquivos físicos no dispositivo. |
| WPD_FUNCTIONAL_CATEGORY_VIDEO_CAPTURE | O objeto encapsula a funcionalidade de captura de vídeo no dispositivo, por exemplo, um componente de gravador de vídeo. Um aplicativo usa esse objeto para obter controle programático. |
Tópicos relacionados