Partilhar via


WPD_CONTENT_TYPE_FUNCTIONAL_OBJECT

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.

 

Requisitos para objetos