Interface IWMProfile
[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.