Compartilhar via

Requisitos para que jogadores de áudio portáteis apareçam no Windows Explorer

  • Artigo

A extensão de namespace do shell do player de áudio portátil fornece aos usuários do Windows uma maneira consistente de gerenciar dispositivos de áudio gerenciados pelo Windows Media Gerenciador de Dispositivos. Se você criar seu provedor de serviços e componentes de driver de acordo com as diretrizes a seguir, seu dispositivo aparecerá no namespace do shell. Os usuários poderão interagir com o conteúdo do dispositivo de maneira consistente no Windows Explorer executar operações básicas, como copiar, excluir e renomear.

Os requisitos de shell a seguir para o provedor de serviços e os componentes de driver destinam-se a complementar as diretrizes gerais de Gerenciador de Dispositivos do Windows Media.

Funcionalidades do dispositivo

Os provedores de serviços do Windows Media Gerenciador de Dispositivos devem ser explícitos em seus recursos com suporte. Se não houver suporte para uma chamada, um código de erro deverá ser retornado. Os campos apropriados devem ser definidos para a presença ou ausência de recursos no retorno das seguintes funções:

Os provedores de serviços devem dar suporte aos seguintes recursos para serem compatíveis com o shell:

  • Copiar para o dispositivo (com suporte para cancelamento e progresso de retornos de chamada)
  • Excluir arquivo do dispositivo (com suporte para cancelamento e progresso de retornos de chamada)
  • Renomear arquivo no dispositivo
  • Relatórios espaciais (espaço total, espaço livre, espaço inutilizável)
  • Plug and Play (consulte Habilitando o PnP para dispositivos)
  • Formatar (preferencialmente com suporte para cancelamento e progresso de retornos de chamada)

Se houver suporte para metadados, os campos a seguir deverão ter suporte para arquivos individuais. Se nenhum dado estiver disponível, o campo deverá ser inicializado como uma cadeia de caracteres vazia:

Campo Constante (definida em WMDM.idl) Marca de metadados
Título da Canção g_wszWMDMTitle WMDM/Title
Rastrear Número g_wszWMDMTrack WMDM/Track
Artista g_wszWMDMAuthor WMDM/Author
Álbum g_wszWMDMAlbumTitle WMDM/AlbumTitle
Year g_wszWMDMYear WMDM/Ano
Gênero g_wszWMDMGenre WMDM/Gênero

 

Simultaneidade

Os drivers de modo kernel para o Windows Media Gerenciador de Dispositivos precisam ser robustos na manipulação do acesso simultâneo. Por exemplo, um usuário pode estar acessando simultaneamente o dispositivo por meio do shell e do media player ou simplesmente por meio de várias janelas no shell. Como parte da manipulação da simultaneidade, os drivers não devem assumir, apenas porque o provedor de serviços está carregado, que o dispositivo está em uso. Em vez disso, eles devem implementar um mecanismo de bloqueio para serializar o acesso ao dispositivo conforme necessário para operações individuais.

Interface do usuário

Os provedores de serviços do Windows Media Gerenciador de Dispositivos não devem mostrar nenhuma interface do usuário. Todos os erros devem ser retornados de chamadas de método como códigos de erro específicos do Windows Media Gerenciador de Dispositivos sempre que possível.

Habilitando no Shell

Se o pacote atender a todos os requisitos do shell, você poderá permitir que seu dispositivo seja mostrado no shell definindo o valor ShowInShell como 1 nos parâmetros do dispositivo. Para obter mais informações, consulte Parâmetros do dispositivo.

Criando um provedor de serviços