Objeto Profile
[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 do 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 do 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.]
Um objeto de perfil gerencia as configurações de um perfil. Objetos de perfil podem ser criados para dados de perfil existentes ou podem ser criados vazios, prontos para receber novos dados. Um objeto de perfil também é criado pelo objeto leitor (e o objeto leitor síncrono) quando um arquivo é carregado para leitura. Nesse caso, o objeto é preenchido com as informações de perfil armazenadas no cabeçalho do arquivo.
Para salvar o conteúdo de um objeto de perfil, você deve chamar IWMProfileManager::SaveProfile.
Um perfil contém vários objetos que controlam vários aspectos do perfil (como fluxos). Todos esses objetos são subordinados ao objeto de perfil. Você não cria esses objetos com funções de criação como faria com os principais objetos desse SDK. Em vez disso, as interfaces do objeto de perfil contêm métodos que criam os objetos subordinados.
Para criar um objeto de perfil, chame um dos métodos a seguir.
| Método | Descrição |
|---|---|
| IWMProfileManager::CreateEmptyProfile | Cria um objeto de perfil sem dados de perfil. |
| IWMProfileManager::LoadProfileByData | Cria um objeto de perfil preenchido com dados de um perfil salvo como uma cadeia de caracteres. Essa é a única maneira de criar um objeto de perfil com dados de um perfil personalizado. |
| IWMProfileManager::LoadProfileByID | Cria um objeto de perfil preenchido com dados de um perfil do sistema. Usa o GUID para identificar o perfil de sistema desejado. |
| IWMProfileManager::LoadSystemProfile | Cria um objeto de perfil preenchido com dados de um perfil do sistema. Usa o índice de perfil para identificar o perfil de sistema desejado. |
Todos os métodos na tabela anterior definem um ponteiro para uma interface IWMProfile . As outras interfaces do objeto de perfil podem ser obtidas chamando o método QueryInterface .
As interfaces a seguir são compatíveis com cada objeto de perfil.
| Interface | Descrição |
|---|---|
| IWMLanguageList | Gerencia uma lista de idiomas compatíveis com um arquivo ASF. |
| IWMPacketSize | Controla o tamanho máximo de pacotes em um arquivo. |
| IWMPacketSize2 | Controla o tamanho mínimo dos pacotes em um arquivo. Herda todos os métodos de IWMPacketSize. |
| IWMProfile | Controla as configurações básicas e os objetos incluídos em um perfil. |
| IWMProfile2 | Recupera o GUID (identificador global exclusivo) associado ao perfil. Herda todos os métodos de IWMProfile. |
| IWMProfile3 | Controla o compartilhamento de largura de banda e as informações de priorização de fluxo em um perfil. Herda todos os métodos de IWMProfile e IWMProfile2. |
Tópicos relacionados