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

Tópicos relacionados

Referência de programação