Objetos (Windows Media Format 11 SDK)
[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.]
O SDK do Windows Media Format usa vários objetos para ler, escrever, editar e indexar arquivos ASF e para criar e editar perfis. Cada objeto suporta várias interfaces. Algumas interfaces são suportadas 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 do Windows Media Format 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 método de criação em vez de usar manualmente a função COM CoCreateInstance.
Algumas interfaces têm um número anexado aos 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 suportados por este 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 |
|---|---|---|
| Backup Restorer | Faz backup de licenças, normalmente em mídia removível, e restaura essas licenças em um computador diferente. | WMCreateBackupRestorer |
| de Registro de Dispositivos | Gerencia o banco de dados de registro de dispositivos, que contém entradas para dispositivos de reprodução de mídia 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 Windows Media DRM 10 para dispositivos de rede. | WMCreateDRMTranscryptor |
| Indexador | Cria um índice para arquivos ASF para permitir a busca em arquivos com fluxos de vídeo. | WMCreateIndexer |
| Agente de Revogação de Licença | Gerencia a revogação de licenças. | WMCreateLicenseRevocationAgent |
| Editor de metadados | Edita metadados em um cabeçalho de arquivo ASF. | WMCreateEditor |
| do Profile Manager | Fornece interfaces para criar, carregar e salvar perfis. Um perfil é necessário para escrever um arquivo ASF. | WMCreateProfileManager |
| Reader | Lê arquivos ASF. Este 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 |
| do coletor de arquivos do Writer | Controla arquivos ASF gravados pelo objeto writer. | WMCreateWriterFileSink |
| Writer Network Sink | Controla o streaming de rede ao vivo de arquivos ASF gravados pelo objeto writer. | WMCreateWriterNetworkSink |
| Writer Push Sink | Controla a entrega de conteúdo de streaming para servidores de publicação. | WMCreateWriterPushSink |
A tabela a seguir lista 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 o compartilhamento de informações de largura de banda em um perfil. Mais de um objeto de compartilhamento de largura de banda pode existir para um perfil. Existem diferentes métodos 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 uma amostra de mídia e quaisquer extensões de unidade de dados associadas. Usado para amostras de escrita e leitura. |
IWMWriter::AllocateSampleOU IWMReaderAllocatorEx::AllocateForOutputEx OU IWMReaderAllocatorEx::AllocateForStreamEx OU Criado automaticamente pelo objeto leitor ou objeto leitor síncrono para entrega de amostra. |
| Propriedades da 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á diferentes métodos 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 da 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 ele está sendo manipulado. Os objetos de perfil são criados sempre que o perfil precisa ser manipulado. Existem 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 |
| de configuração de fluxo | Gerencia as propriedades de um fluxo dentro de 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 |
| de priorização de fluxo | Mantém a lista de prioridades de fluxo para um perfil. Os fluxos serão descartados em ordem crescente de prioridade se a largura de banda disponível for restrita. Só pode haver um objeto de priorização de fluxo em um perfil. | IWMProfile3::CreateNewStreamPrioritization |