Objeto de perfil
[A funcionalidade associada a esta página, Windows Media Format 11 SDK, é uma funcionalidade herdada. Foi substituído por Source Reader e Sink Writer. do Source Reader e Sink Writer foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda vivamente que o novo código utilize do Leitor de Origem e do Gravador de Separadores em vez de SDK do Windows Media Format 11, sempre que 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. Os 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 reader (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 aspetos 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 deste 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 seguintes métodos.
| 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. Esta é 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 um interface de IWMProfile. As outras interfaces do objeto de perfil podem ser obtidas chamando o método QueryInterface.
As interfaces a seguir são suportadas por cada objeto de perfil.
| Interface | Descrição |
|---|---|
| IWMLanguageList | Gerencia uma lista de idiomas suportados por um arquivo ASF. |
| IWMPacketSize | Controla o tamanho máximo de pacotes em um arquivo. |
| IWMPacketSize2 | Controla o tamanho mínimo de 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 identificador global exclusivo (GUID) associado ao perfil. Herda todos os métodos de IWMProfile. |
| IWMProfile3 | Controla o compartilhamento de largura de banda e informações de priorização de fluxo em um perfil. Herda todos os métodos de IWMProfile e IWMProfile2. |
Tópicos relacionados