Interface IWMProfile

  • Artigo

[O recurso associado a esta página, Windows Media Format 11 SDK, é um recurso herdado. Ele foi substituído por Leitor de Origem e Gravador de Coletor. O Leitor de Origem e o Gravador de Coletor foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o Leitor de Origem e o Gravador de Coletor em vez do SDK do Windows Media Format 11, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

A interface IWMProfile é a interface primária de um objeto de perfil . Um objeto de perfil é usado para configurar perfis personalizados. Você pode usar IWMProfile para criar, excluir ou modificar objetos de configuração de fluxo e objetos de exclusão mútua. Você também pode definir e recuperar informações gerais sobre o perfil. Para acessar todos os recursos do objeto de perfil, você deve usar IWMProfile3, que herda de IWMProfile e IWMProfile2.

O IWMProfile também é acessível por meio do objeto leitor, no qual você pode usá-lo para obter informações sobre os fluxos de um arquivo carregado no leitor. Ao acessar IWMProfile do leitor, você pode fazer alterações no perfil, mas nenhuma das alterações pode ser salva no arquivo. Geralmente, é útil usar o perfil de um arquivo existente como a base de um novo perfil. O leitor síncrono dá suporte a IWMProfile da mesma forma que o leitor.

As informações de perfil obtidas por meio do leitor ou leitor síncrono não vêm de um arquivo .prx. O leitor usa as informações no arquivo ASF para montar as configurações de fluxo. Portanto, determinadas informações de perfil, como o nome e a descrição, não estão disponíveis por meio do leitor.

Há várias maneiras de obter um ponteiro para uma interface IWMProfile . O gerenciador de perfil tem métodos para criar um novo perfil e acessar perfis existentes. Todos esses métodos definem um ponteiro IWMProfile . Ao ler um arquivo, um ponteiro para IWMProfile pode ser obtido chamando o método QueryInterface de qualquer interface de leitor. Da mesma forma, qualquer interface do objeto leitor síncrono pode obter um ponteiro com uma chamada para QueryInterfaceIWMProfile3.

Membros

A interface IWMProfile herda da interface IUnknown . O IWMProfile também tem esses tipos de membros:

Métodos

A interface IWMProfile tem esses métodos.

Método Descrição
AddMutualExclusion Adiciona um objeto de exclusão mútua ao perfil.
AddStream Adiciona um fluxo ao perfil.
CreateNewMutualExclusion Cria um objeto de exclusão mútua para o perfil.
CreateNewStream Cria um objeto de configuração de fluxo para o perfil.
GetDescription Recupera a descrição do perfil.
GetMutualExclusion Recupera um objeto de exclusão mútua do perfil.
GetMutualExclusionCount Recupera o número de objetos de exclusão mútua no perfil.
GetName Recupera o nome do perfil.
Getstream Recupera um fluxo, usando um número de índice, do perfil.
GetStreamByNumber Recupera um fluxo, usando o número do fluxo, do perfil.
GetStreamCount Recupera o número de fluxos no perfil.
GetVersion Recupera o número de versão dos Serviços de Mídia do Microsoft Windows no perfil.
ReconfigStream Permite que as alterações feitas em uma configuração de fluxo sejam incluídas no perfil.
RemoveMutualExclusion Remove um objeto de exclusão mútua do perfil.
RemoveStream Remove um fluxo do perfil.
RemoveStreamByNumber Remove um fluxo do perfil.
SetDescription Especifica a descrição do perfil.
Setname Especifica o nome do perfil.

Para obter informações sobre quais interfaces podem ser obtidas usando o método QueryInterface dessa interface, consulte o tópico do objeto no qual essa interface é implementada.

Confira também

Interfaces

IWMProfileManager Interface

Objeto do gerenciador de perfis

Objeto de leitor

Objeto de leitor síncrono

Trabalhando com perfis