Objetos (SDK do Windows Media Format 11)
[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.]
O SDK do Windows Media Format usa vários objetos para ler, gravar, editar e indexar arquivos ASF e para criar e editar perfis. Cada objeto dá suporte a várias interfaces. Há suporte para algumas interfaces em vários objetos. Nesses casos, quaisquer diferenças na implementação são discutidas na seção de referência para a interface .
Os objetos no SDK de Formato de Mídia do Windows são compatíveis com COM. Para facilitar o desenvolvimento, cada objeto tem uma função ou método de criação associado. Você deve criar objetos usando a função ou o método de criação em vez de usar manualmente a função COM CoCreateInstance.
Algumas interfaces têm um número acrescentado a seus nomes, como IWMProfile2 e IWMWriter3. Em cada caso, as versões numeradas herdam todos os métodos das versões anteriores e adicionam novas funcionalidades.
Em cada página de objeto dessa referência, as interfaces incluídas no objeto COM main são listadas primeiro, seguidas por interfaces de retorno de chamada que devem ser implementadas pelo aplicativo.
A tabela a seguir lista os objetos compatíveis com esse SDK com uma descrição da funcionalidade de cada um e a função usada para criá-lo.
| Objeto | Descrição | Função de criação |
|---|---|---|
| Restaurador de Backup | Faz backup de licenças, normalmente em mídia removível e, em seguida, restaura essas licenças em um computador diferente. | WMCreateBackupRestorer |
| Registro de dispositivo | Gerencia o banco de dados de registro de dispositivo, que contém entradas para dispositivos de reprodução de mídia que estão disponíveis por meio de uma conexão de rede. | WMCreateDeviceRegistration |
| DRM Transcryptor | Converte dados de mídia protegidos por DRM em um fluxo de dados que pode ser enviado para dispositivos que usam o protocolo DRM 10 do Windows Media para Dispositivos de Rede. | WMCreateDRMTranscryptor |
| Indexador | Cria um índice para arquivos ASF para habilitar a busca em arquivos com fluxos de vídeo. | WMCreateIndexer |
| Agente de Revogação de Licença | Gerencia a revogação de licença. | WMCreateLicenseRevocationAgent |
| Editor de metadados | Edita metadados em um cabeçalho de arquivo ASF. | WMCreateEditor |
| Gerenciador de Perfis | Fornece interfaces para criar, carregar e salvar perfis. Um perfil é necessário para gravar um arquivo ASF. | WMCreateProfileManager |
| Leitor | Lê arquivos ASF. Esse objeto usa um modelo de chamada assíncrona para suas operações. | WMCreateReader |
| Leitor Síncrono | Lê arquivos ASF usando chamadas síncronas. | WMCreateSyncReader |
| Escritor | Grava arquivos ASF. | WMCreateWriter |
| Coletor de Arquivos do Gravador | Controla arquivos ASF gravados pelo objeto gravador. | WMCreateWriterFileSink |
| Coletor de Rede do Gravador | Controla a transmissão de rede ao vivo de arquivos ASF gravados pelo objeto gravador. | WMCreateWriterNetworkSink |
| Coletor de Push do Gravador | Controla a entrega de conteúdo de streaming para servidores de publicação. | WMCreateWriterPushSink |
A tabela a seguir lista objetos dependentes de outros objetos. Esses objetos são criados por métodos de objetos existentes.
| Objeto | Descrição | Método de criação |
|---|---|---|
| Compartilhamento de largura de banda | Gerencia informações de compartilhamento de largura de banda em um perfil. Mais de um objeto de compartilhamento de largura de banda pode existir para um perfil. Há métodos diferentes para criar um objeto de compartilhamento de largura de banda, dependendo se você deseja criar um novo objeto de compartilhamento de largura de banda ou acessar um existente. |
IWMProfile3::CreateNewBandwidthSharingOU IWMProfile3::GetBandwidthSharing |
| Buffer | Contém um exemplo de mídia e quaisquer extensões de unidade de dados associadas. Usado para escrever e ler amostras. |
IWMWriter::AllocateSampleOU IWMReaderAllocatorEx::AllocateForOutputEx OU IWMReaderAllocatorEx::AllocateForStreamEx OU Criado automaticamente pelo objeto leitor ou objeto de leitor síncrono para entrega de exemplo. |
| Propriedades de mídia de entrada | Gerencia as propriedades de uma entrada. Um objeto de propriedades de entrada pode existir para cada entrada. | IWMWriter::GetInputProps |
| Exclusão mútua | Gerencia informações de exclusão mútua em um perfil. Os usos comuns para exclusão mútua são conteúdo de taxa de bits múltipla e trilhas sonoras em vários idiomas. Há métodos diferentes para criar um objeto de exclusão mútua, dependendo se você deseja criar um novo objeto de exclusão mútua ou acessar um existente. |
IWMProfile::CreateNewMutualExclusionOU IWMProfile::GetMutualExclusion |
| Propriedades de mídia de saída | Gerencia as propriedades de uma saída. Um objeto de propriedades de mídia de saída pode existir para cada saída. Esses objetos podem ser criados pelo leitor ou pelo leitor síncrono |
IWMReader::GetOutputPropsOU IWMSyncReader::GetOutputProps |
| Perfil | Contém os dados em um perfil enquanto eles estão sendo manipulados. Os objetos de perfil são criados sempre que o perfil precisa ser manipulado. Há diferentes métodos para criar um objeto de perfil, dependendo se você deseja criar um novo perfil ou acessar um existente. |
IWMProfileManager::CreateEmptyProfileOU IWMProfileManager::LoadProfileByData OU IWMProfileManager::LoadProfileByID OU IWMProfileManager::LoadSystemProfile |
| Configuração do Fluxo | Gerencia as propriedades de um fluxo em um perfil. Os objetos de configuração de fluxo são criados por objetos de fluxo sempre que você precisa acessar as informações sobre um fluxo. Há diferentes métodos para criar um objeto de configuração de fluxo, dependendo se você deseja criar um novo fluxo ou acesso e existente. |
IWMProfile::CreateNewStreamOU IWMProfile::GetStream OU IWMProfile::GetStreamByNumber |
| Priorização de fluxo | Mantém a lista de prioridades de fluxo para um perfil. Os fluxos serão descartados por ordem de prioridade crescente se a largura de banda disponível for restrita. Só pode haver um objeto de priorização de fluxo em um perfil. | IWMProfile3::CreateNewStreamPrioritization |