Compartilhar 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, 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 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 Necessá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 Necessá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 Necessá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 for 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 Necessá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 categorias definidas por Dispositivos Portáteis do Windows.

 

Recursos típicos

Esses objetos normalmente 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 do serviço de mensagens curtas (geralmente 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 um 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 de para objetos