Interfaces para aplicativos

Esta seção descreve as interfaces usadas ou implementadas por aplicativos que usam o SDK do Windows Media Gerenciador de Dispositivos para se comunicar com dispositivos. O termo "aplicativo" usado aqui significa qualquer objeto executável, plug-in ou COM existente em um computador desktop e precisa de comunicação de alto nível com um dispositivo portátil conectado. Isso pode incluir um aplicativo media player, um plug-in Reprodutor Multimídia do Windows (se precisar de acesso direto a um dispositivo portátil) ou um objeto COM de medição de contagem de reprodução.

Algumas dessas interfaces são implementadas pelo aplicativo, enquanto outras são chamadas pelo aplicativo. A documentação de cada interface indica se ela é implementada ou chamada (e, se implementada, se é opcional ou necessária).

As interfaces ou classes a seguir são usadas por aplicativos.

Interface ou classe	Descrição
Classe CSecureChannelClient	Uma classe auxiliar que permite que os aplicativos se autentiquem, criptografem e descriptografem dados e criem MACs.
IWMDeviceManager	A interface de Gerenciador de Dispositivos do Windows Media de nível superior para aplicativos.
IWMDeviceManager2	Estende IWMDeviceManager fornecendo métodos avançados de enumeração e outros métodos.
IWMDeviceManager3	Estende a interface IWMDeviceManager2 fornecendo um método que define a preferência de enumeração do dispositivo.
IWMDMDevice	Fornece métodos para examinar e explorar um único dispositivo portátil.
IWMDMDevice2	Estende IWMDMDevice tornando possível obter os formatos de vídeo compatíveis com um dispositivo, localizar um armazenamento por nome e usar páginas de propriedades.
IWMDMDevice3	Estende IWMDMDevice2 fornecendo métodos para consultar um dispositivo em busca de propriedades, enviar códigos de controle de E/S do dispositivo e também fornecer métodos atualizados para pesquisar armazenamentos e recuperar recursos de formato de dispositivo.
IWMDMDeviceControl	Fornece métodos para controlar dispositivos.
IWMDMDeviceSession	Melhora a eficiência das operações de dispositivo agrupando várias operações em uma sessão
IWMDMEnumDevice	Enumera dispositivos portáteis anexados a um computador.
IWMDMEnumStorage	Enumera armazenamentos em um dispositivo.
IWMDMMetaData	Define e recupera propriedades de metadados (como artista, álbum, gênero e assim por diante) de um armazenamento.
IWMDMObjectInfo	Obtém e define informações que controlam como os arquivos reproduzíveis no dispositivo são tratados pela interface IWMDMDeviceControl
IWMDMRevoked	Recupera a URL da qual os componentes atualizados podem ser baixados, se uma transferência falhar com um erro de revogação.
IWMDMStorage	Fornece métodos para examinar e explorar um armazenamento (arquivo, pasta, playlist) em um dispositivo.
IWMDMStorage2	Estende IWMDMStorage , tornando possível obter um armazenamento filho por nome e obter e definir atributos estendidos.
IWMDMStorage3	Estende IWMDMStorage2 expondo metadados.
IWMDMStorage4	Estende IWMDMStorage3 fornecendo métodos para recuperar um subconjunto de metadados disponíveis para um armazenamento e para definir e recuperar uma lista de referências a outros armazenamentos.
IWMDMStorageControl	Usado para inserir, excluir ou mover arquivos dentro de um dispositivo ou entre um dispositivo e o computador.
IWMDMStorageControl2	Estende IWMDMStorageControl tornando possível definir o nome do arquivo de destino ao inserir conteúdo em um armazenamento.
IWMDMStorageControl3	Estende IWMDMStorageControl2 , tornando possível passar um ponteiro de interface IWMDMetaData .
IWMDMStorageGlobals	Fornece métodos para recuperar informações globais sobre um meio de armazenamento (como um cartão flash ROM) em um dispositivo.
IWMDRMDeviceApp	Permite que um aplicativo execute medição, sincronização de licença e atualização dos componentes drm de um dispositivo.
IWMDRMDeviceApp2	Estende IWMDRMDeviceApp fornecendo uma nova versão do método QueryDeviceStatus .

 

Interfaces de retorno de chamada

As interfaces opcionais a seguir são implementadas por um aplicativo para acompanhar o progresso de uma solicitação assíncrona, como uma solicitação de leitura ou gravação.

Interface	Descrição
IWMDMNotification	Permite que aplicativos e provedores de serviços recebam notificações quando dispositivos ou armazenamentos de memória (como cartões RAM) estão conectados ou desconectados do computador.
IWMDMOperation2	Estende IWMDMOperation fornecendo métodos para obter e definir atributos estendidos.
IWMDMOperation3	Estende IWMDMOperation fornecendo um novo método para transferir dados não criptografados para maior eficiência.
IWMDMOperation	Permite que um aplicativo controle como os dados são lidos ou gravados no computador durante uma transferência de arquivo.
IWMDMProgress2	Estende o método IWMDMProgress::End fornecendo um indicador de status.
IWMDMProgress3	Estende IWMDMProgress2 fornecendo parâmetros de entrada adicionais para especificar a ID do evento e informações específicas do contexto.
IWMDMProgress	Permite que um aplicativo acompanhe o progresso das operações, como a formatação de mídia ou transferências de arquivos.

 

O diagrama a seguir mostra como a maioria das interfaces de aplicativo importantes são adquiridas da interface IWMDeviceManager raiz. Um aplicativo obtém essa interface raiz cocriando o objeto MediaDevMgr, solicitando a interface IComponentAuthenticate , autenticando o componente e solicitando o IWMDeviceManager (essas etapas são descritas em Autenticando o aplicativo). Depois que essa interface raiz é adquirida, IWMDeviceManager::EnumDevices é chamado para criar um objeto que implementa IWMDMEnumDevice. Outras interfaces são obtidas chamando métodos em interfaces na ordem mostrada. Interfaces derivadas, como IWMDMDevice2 , são obtidas chamando QueryInterface na interface base.

No diagrama a seguir, as interfaces derivadas são rotuladas por marcas de barra, de modo que "IWMDMStorage/2/3" indicaria IWMDMStorage, IWMDMStorage2 e IWMDMStorage3.

Tópicos relacionados

Referência de programação