Aceder a metadados e atributos na aplicação
Uma discussão geral sobre metadados e atributos está disponível em Obtendo e definindo metadados e atributos. Esta seção aborda chamadas de método de aplicativo específicas 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 o aplicativo pode enumerar 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 ao preencher o parâmetro ppwszPropNames com uma matriz das cadeias de caracteres das propriedades desejadas do Gestor de Dispositivos do Windows Media, bem como 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 devolvidos com base no melhor esforço.
Um dispositivo pode definir atributos ou metadados em um armazenamento chamando IWMDMStorage::SetAttributes, IWMDMStorage2::SetAttributes2ou IWMDMStorage3::SetMetadata. Observe que não há garantia de que os valores definidos persistirão, porque eles podem ser armazenados em um armazenamento de arquivos externo não persistente, os valores podem não ser suportados ou o dispositivo pode não suportar as 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 de dispositivo listadas no final de Constantes de metadados.
Exemplos de utilização destes métodos são dados na documentação de referência de cada método.
Tópicos relacionados