Objetos (SDK do Windows Media Format 11)
[O recurso associado a esta página, do SDK do Windows Media Format 11, é um recurso herdado. Foi substituído por de Leitor de Origem e do Gravador do Coletor de. de Leitor de Origem e Gravador do Coletor foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use de Leitor de Origem e o Gravador do Coletor em vez de 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 Formato de Mídia do Windows usa vários objetos para ler, gravar, editar e indexar arquivos ASF e criar e editar perfis. Cada objeto dá suporte a várias interfaces. Há suporte para algumas interfaces em vários objetos. Nesses casos, todas as diferenças na implementação são discutidas na seção de referência da 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 principal 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 da função usada para criá-lo.
| Objeto | Descrição | Função de criação |
|---|---|---|
| do Restaurador de Backup | Faz backup de licenças, normalmente em mídia removível e restaura essas licenças em um computador diferente. | WMCreateBackupRestorer |
| de 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 |
| transcryptor DRM | 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 |
| do Indexador | Cria um índice para arquivos ASF para habilitar a busca em arquivos com fluxos de vídeo. | WMCreateIndexer |
| do Agente de Revogação de Licenças | Gerencia a revogação de licença. | WMCreateLicenseRevocationAgent |
| Editor de Metadados do | Edita metadados em um cabeçalho de arquivo ASF. | WMCreateEditor |
| do Gerenciador de Perfis do | Fornece interfaces para criar, carregar e salvar perfis. Um perfil é necessário para gravar um arquivo ASF. | WMCreateProfileManager |
| leitor de | Lê arquivos ASF. Esse objeto usa um modelo de chamada assíncrono para suas operações. | WMCreateReader |
| de Leitor Síncrono | Lê arquivos ASF usando chamadas síncronas. | WMCreateSyncReader |
| de Gravador de | Grava arquivos ASF. | WMCreateWriter |
| do Coletor de Arquivos do Gravador de | Controla arquivos ASF gravados pelo objeto gravador. | WMCreateWriterFileSink |
| do Coletor de Rede do Gravador de | Controla a transmissão de rede ao vivo de arquivos ASF gravados pelo objeto gravador. | WMCreateWriterNetworkSink |
| do Coletor de Push do Gravador | Controla a entrega de conteúdo de streaming para servidores de publicação. | WMCreateWriterPushSink |
A tabela a seguir lista os objetos que dependem de outros objetos. Esses objetos são criados por métodos de objetos existentes.
| Objeto | Descrição | Método de criação |
|---|---|---|
| de 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::CreateNewBandwidthSharingOR IWMProfile3::GetBandwidthSharing |
| de Buffer | Contém um exemplo de mídia e quaisquer extensões de unidade de dados associadas. Usado para exemplos de gravação e leitura. |
IWMWriter::AllocateSampleOR IWMReaderAllocatorEx::AllocateForOutputEx OU IWMReaderAllocatorEx::AllocateForStreamEx OU Criado automaticamente pelo objeto leitor ou objeto 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 |
| de 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::CreateNewMutualExclusionOR 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::GetOutputPropsOR IWMSyncReader::GetOutputProps |
| de Perfil do | 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á métodos diferentes para criar um objeto de perfil, dependendo se você deseja criar um novo perfil ou acessar um existente. |
IWMProfileManager::CreateEmptyProfileOR IWMProfileManager::LoadProfileByData OU IWMProfileManager::LoadProfileByID OU IWMProfileManager::LoadSystemProfile |
| de configuração de fluxo | Gerencia as propriedades de um fluxo dentro de um perfil. 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á métodos diferentes para criar um objeto de configuração de fluxo, dependendo se você deseja criar um novo fluxo ou acesso e um existente. |
IWMProfile::CreateNewStreamOR IWMProfile::GetStream OU IWMProfile::GetStreamByNumber |
| de Priorização do Fluxo de | Mantém a lista de prioridade de fluxo para um perfil. Os fluxos serão removidos 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 |