Compartilhar via


Acessando metadados e atributos no aplicativo

Uma discussão geral sobre metadados e atributos está disponível em Obtenção e Configuração de Metadados e Atributos. Esta seção aborda chamadas específicas do método de aplicativo para recuperar ou definir valores.

Os aplicativos podem recuperar atributos ou metadados sobre um armazenamento específico chamando IWMDMStorage::GetAttributes, IWMDMStorage2::GetAttributes2, IWMDMStorage3::GetMetadata ou IWMDMStorage4::GetSpecifiedMetadata. GetMetadata recupera uma coleção completa de todos os metadados associados a um armazenamento e, em seguida, o aplicativo pode enumerar por meio de todos os valores ou solicitar valores específicos da coleção. GetSpecifiedMetadata cria um objeto de metadados em nome do chamador. O chamador pode solicitar um subconjunto dos dados disponíveis preenchendo o parâmetro ppwszPropNames com uma matriz das cadeias de caracteres de propriedade de Gerenciador de Dispositivos do Windows Media desejadas e a contagem dessa matriz. O objeto de metadados retornado será preenchido com as propriedades que podem ser recuperadas. As propriedades que não puderam ser recuperadas estarão ausentes. Os metadados são retornados com o melhor esforço.

Um dispositivo pode definir atributos ou metadados em um armazenamento chamando IWMDMStorage::SetAttributes, IWMDMStorage2::SetAttributes2 ou IWMDMStorage3::SetMetadata. Observe que não há nenhuma garantia de que todos os valores definidos persistirão, pois eles podem ser armazenados em um repositório de arquivos externo não persistente, os valores podem não ter suporte ou, o dispositivo pode não dar suporte às propriedades como graváveis.

Você também pode obter ou definir metadados sobre um dispositivo chamando IWMDMDevice3::GetProperty ou IWMDMDevice3::SetProperty. Há uma tabela separada de constantes de metadados do dispositivo listadas no final das Constantes de Metadados.

Exemplos de uso desses métodos são dados na documentação de referência de cada método.

Criando um aplicativo de Gerenciador de Dispositivos do Windows Media

Obtendo e definindo metadados e atributos