Compartilhar via

WPD_CONTENT_TYPE_FUNCTIONAL_OBJECT

  • Artigo

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, dão suporte às propriedades a seguir. (Se você definir um objeto funcional personalizado, ele também deverá dar 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 Obrigatórios.
WPD_OBJECT_NAME Obrigatórios.
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 Obrigatórios.
WPD_OBJECT_CONTENT_TYPE Obrigatórios.
WPD_OBJECT_ISHIDDEN Obrigatório se o objeto estiver oculto.
WPD_OBJECT_ISSYSTEM Obrigató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 representa um arquivo.
WPD_OBJECT_NON_CONSUMABLE Recomendado se o objeto não for destinado 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 Obrigatório se o objeto for protegido pela tecnologia DRM.
WPD_OBJECT_DATE_CREATED Opcional.
WPD_OBJECT_DATE_MODIFIED Recomendável.
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 Obrigatórios. Consulte a tabela a seguir para obter categorias definidas por Dispositivos Portáteis do Windows.

 

Recursos típicos

Normalmente, esses objetos não hospedam recursos.

Categorias de objeto funcional

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 têm suporte.

A tabela a seguir descreve as categorias definidas por Dispositivos Portáteis do Windows. Consulte a descrição da categoria para saber quais propriedades e recursos adicionais o objeto dá suporte.

Categoria Funcional Descrição
WPD_FUNCTIONAL_CATEGORY_ALL Essa categoria funcional é válida apenas como um parâmetro para determinadas funções de consulta (para indicar que todos os tipos de objeto funcionais 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 importante 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 pode reproduzir.
WPD_FUNCTIONAL_CATEGORY_SMS O objeto encapsula a funcionalidade de serviço de mensagem curta (normalmente chamada de "mensagens de texto") no dispositivo.
WPD_FUNCTIONAL_CATEGORY_STILL_IMAGE_CAPTURE O objeto encapsula a funcionalidade de captura de imagem ainda em um dispositivo, como uma câmera ou anexo 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