Windows Media Format SDK Interfaces
[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.]
As duas tabelas a seguir descrevem as interfaces suportadas por este SDK e mostram sua relação com objetos e outras interfaces.
| Interface | Descrição |
|---|---|
| INSNetSourceCreator | Cria uma fonte de rede administrativa plug-in, que pode ser usada para armazenar senhas em cache e localizar servidores proxy. |
| INSSBuffer | Controla um buffer armazenado em um objeto de buffer. Essa interface é usada para passar amostras de e para métodos neste SDK. |
| INSSBuffer2 | Herda de INSSBuffer. Os novos métodos desta interface não estão documentados porque não estão implementados nesta versão. |
| INSSBuffer3 | Define e recupera propriedades de buffer. As propriedades de buffer são usadas para transmitir informações com um buffer quando passadas de ou para métodos deste SDK. |
| INSSBuffer4 | Enumera propriedades de buffer. |
| IReferenceClock | Fornece acesso a um relógio de referência padrão. |
| IRMGetLicense | Executa a aquisição de licenças do lado do cliente. |
| IWMAddressAccess | Controla as listas de acesso IP no objeto coletor de rede do gravador. |
| IWMAddressAccess2 | Adiciona suporte IPv6 à interface IWMAddressAccess. |
| IWMAuthorizer | Fornece acesso a certificados. |
| IWMBackupRestoreProps | Define, recupera e remove as propriedades exigidas pelas interfaces IWMLicenseBackup e IWMLicenseRestore. |
| IWMBandwidthSharing | Configura objetos de compartilhamento de largura de banda. Os objetos de compartilhamento de largura de banda são criados por objetos de perfil para especificar fluxos que, independentemente de suas taxas de bits individuais, nunca usarão mais do que uma certa quantidade de largura de banda entre eles. |
| IWMClientConnections | Recupera informações sobre clientes conectados a um objeto coletor de rede do gravador. |
| IWMClientConnections2 | Recupera informações avançadas sobre clientes conectados a um objeto coletor de rede do gravador. |
| IWMCodecAMVideoAccelerator | Exposto pelo Windows Media Decoder DMO e chamado pelo filtro de origem de um media player para configurar as várias conexões necessárias para habilitar o DirectX VA para decodificação de conteúdo do Windows Media Video. |
| IWMCodecInfo | Recupera os formatos disponíveis para os codecs de áudio suportados carregados no sistema. Esses formatos são usados ao criar fluxos de áudio em perfis. |
| IWMCodecInfo2 | Fornece acesso aos nomes dos codecs e descrições dos formatos suportados por cada um. |
| IWMCodecInfo3 | Fornece acesso às propriedades do codec e às propriedades do formato de áudio. Também permite que você consulte codecs para suporte a recursos. |
| IWMCodecVideoAccelerator | Esta interface não é suportada. Em vez disso, use IWMCodecAMVideoAccelerator. |
| IWMCredentialCallback | Adquire as credenciais dos usuários e verifica se eles têm permissão para acessar um site remoto. |
| IWMDeviceRegistration | Gerencia o banco de dados de registro de dispositivos, que contém entradas para dispositivos de reprodução de mídia digital conectados a redes locais. |
| IWMDRMEditor | Permite que os aplicativos examinem propriedades de cabeçalho de DRM sem ter uma licença para o conteúdo protegido. |
| IWMDRMMessageParser | Analisa mensagens recebidas de dispositivos de reprodução de mídia digital. |
| IWMDRMReader | Adquire licenças, configura DRM propriedades e individualiza clientes. |
| IWMDRMReader2 | Lê licenças criadas usando o SDK do Windows Media Rights Manager 10. |
| IWMDRMReader3 | Permite a transcrição de conteúdo fornecendo um método para obter sistemas de proteção aprovados por uma licença. |
| IWMDRMTranscryptor | Converte conteúdo protegido por DRM em um fluxo de dados que pode ser enviado usando o protocolo de transferência segura Windows Media DRM 10 for Network Devices. |
| IWMDRMWriter | Fornece recursos de criação de licença a partir do objeto writer. |
| IWMDRMWriter2 | Configura o gravador para aceitar amostras de fluxo contendo dados criptografados para streaming para dispositivos que suportam o Windows Media DRM 10 para dispositivos de rede. |
| IWMDRMWriter3 | Permite a gravação de amostras de fluxo criptografado para importar conteúdo protegido. |
| IWMGetSecureChannel | Esta interface é usada por uma parte de comunicação para obter a interface deIWMSecureChannelda outra parte. |
| IWMHeaderInfo | Gerencia informações de cabeçalho, como metadados, marcadores de e assim por diante. |
| IWMHeaderInfo2 | Fornece acesso a informações sobre os codecs usados para criar o arquivo. |
| IWMHeaderInfo3 | Fornece suporte à linguagem de atributos e outros recursos avançados de metadados. |
| IWMImageInfo | Recupera quadros "APIC" ID3v2 de um arquivo. O uso dessa interface deve ser evitado em favor do atributo WM/Picture. |
| IWMIndexer | Fornece métodos para indexar arquivos manualmente. |
| IWMIndexer2 | Fornece opções de configuração de indexação. |
| IWMInputMediaProps | Gerencia as propriedades de um fluxo de mídia de entrada. |
| IWMIStreamProps | Lê as propriedades de um IStream objeto. |
| IWMLanguageList | Gerencia a lista de idiomas de um arquivo ASF. |
| IWMLicenseBackup | Faz backup de licenças, normalmente para que elas possam ser restauradas em outro computador. |
| IWMLicenseRestore | Restaura licenças. |
| IWMMediaProps | Fornece acesso à estrutura de tipo de mídia para um fluxo. |
| IWMMetadataEditor | Fornece gerenciamento de arquivos para edição de metadados. |
| IWMMetadataEditor2 | Fornece um método aprimorado para abrir arquivos para uso pelo editor de metadados. |
| IWMMutualExclusion | Configura objetos de exclusão mútua. Um objeto de exclusão mútua é criado por um objeto de perfil para especificar um grupo de fluxos mutuamente exclusivos. |
| IWMMutualExclusion2 | Adiciona suporte de agrupamento e nomenclatura para exclusão mútua. |
| IWMOutputMediaProps | Gerencia as propriedades de um fluxo de saída. |
| IWMPacketSize | Gerencia o tamanho máximo de pacotes em um arquivo ASF. |
| IWMPacketSize2 | Gerencia o tamanho mínimo de pacotes em um arquivo ASF. |
| IWMPlayerHook | Implementado por um aplicativo player que usa DirectX Video Acceleration (DirectX VA). Ele permite que o processamento específico do aplicativo seja executado quando amostras de um fluxo de vídeo são passadas para a placa de vídeo habilitada para DirectX VA para descompactação. |
| IWMPlayerTimestampHook | Implementado no filtro de origem do player ou player. Ele permite que o filtro modifique os carimbos de data/hora nas amostras de vídeo antes de entregá-las a jusante. |
| IWMProfile | Gerencia a criação e edição de perfis. Os perfis descrevem o formato de um arquivo, como tipo de fluxo, taxas de bits e assim por diante. A maioria dos aplicativos usa perfis existentes e não precisa implementar essa interface. |
| IWMProfile2 | Fornece acesso a IDs de perfil. |
| IWMProfile3 | Fornece métodos para lidar com compartilhamento de largura de banda, priorização de fluxo e outros recursos avançados suportados por perfis. |
| IWMProfileManager | Gerencia o carregamento e salvamento de perfis. |
| IWMProfileManager2 | Gerencia os números de versão dos perfis do sistema usados pelo objeto do gerenciador de perfis. |
| IWMProfileManagerLanguage | Gerencia o idioma dos perfis de sistema enumerados. |
| IWMPropertyVault | Fornece uma interface padronizada para gerenciar propriedades. |
| IWMProximityDetection | Valida um dispositivo em uma rede local. Um dispositivo tem de ser validado antes de poder receber dados utilizando o protocolo de transferência segura Windows Media DRM 10 for Network Devices. |
| IWMReader | Gerencia a leitura assíncrona de arquivos ASF. |
| IWMReaderAccelerator | Implementado no objeto WM Reader. É chamado por um jogador ou um filtro de origem do jogador para obter interfaces do decodificador DMO. |
| IWMReaderAdvanced | Fornece recursos avançados do leitor, como um relógio fornecido pelo usuário, alocação de buffer, estatísticas de retorno e recebimento de notificações de seleção de fluxo. |
| IWMReaderAdvanced2 | Fornece uma gama adicional de métodos avançados para um objeto leitor existente. |
| IWMReaderAdvanced3 | Fornece métodos avançados adicionais para o objeto leitor. |
| IWMReaderAdvanced4 | Fornece suporte para seleção de idioma e outros recursos avançados de leitura. |
| IWMReaderAdvanced5 | Permite associar uma interface de retorno de chamada de gancho de jogador ao objeto leitor. |
| IWMReaderAdvanced6 | Permite a proteção de amostras. |
| IWMReaderAllocatorEx | Fornece alternativas expandidas para o AllocateForOutput e métodos de AllocateForStream da interface IWMReaderCallbackAdvanced do. |
| IWMReaderCallback | Implementado pelo aplicativo para fornecer informações de amostra e status sobre uma operação de leitura atual. |
| IWMReaderCallbackAdvanced | Opcionalmente implementado pelo aplicativo para fornecer funcionalidade avançada a um objeto de retorno de chamada de leitor existente. |
| IWMReaderNetworkConfig | Gerencia as definições de configuração de rede. |
| IWMReaderNetworkConfig2 | Fornece recursos adicionais de configuração de rede. |
| IWMReaderPlaylistBurn | Confirma os direitos de DRM para copiar os arquivos de uma lista de reprodução para CD. |
| IWMReaderStreamClock | Usado para definir e cancelar temporizadores em relógios de fluxo, bem como para recuperar o valor atual do relógio de fluxo. |
| IWMReaderTimecode | Fornece informações sobre códigos de tempo SMPTE em um arquivo. |
| IWMReaderTypeNegotiation | Fornece um único método que pode ser usado para testar se determinadas alterações nas propriedades de saída de um fluxo estão funcionando corretamente. |
| IWMRegisterCallback | Permite que o aplicativo obtenha mensagens de status de um objeto coletor. |
| IWMRegisteredDevice | Fornece acesso aos dados em uma entrada no banco de dados de registro de dispositivo. |
| IWMSBufferAllocator | Fornece métodos para alocar buffers em um servidor. |
| IWMSecureChannel | Fornece métodos que permitem que duas DLLs validem uma à outra e executem comunicação segura |
| IWMSInternalAdminNetSource | Gerencia o cache de senhas e o local do proxy. |
| IWMSInternalAdminNetSource2 | Fornece métodos de cache de senha mais seguros do que IWMSInternalAdminNetSource. |
| IWMSInternalAdminNetSource3 | Fornece um método melhorado para localizar servidores proxy. |
| IWMStatusCallback | Implementado pelo aplicativo para responder ao status de vários objetos deste SDK. |
| IWMStreamConfig | Gerencia a configuração de fluxos para uso em perfis. |
| IWMStreamConfig2 | Fornece métodos adicionais de manipulação de fluxo. |
| IWMStreamConfig3 | Gerencia informações de idioma para fluxos. |
| IWMStreamList | Gerencia os vários objetos que definem relações entre fluxos. |
| IWMStreamPrioritization | Fornece métodos para configurar o objeto de priorização de fluxo. |
| IWMSyncReader | Fornece a capacidade de ler arquivos com chamadas síncronas. |
| IWMSyncReader2 | Adiciona suporte a código de tempo SMPTE ao leitor síncrono. |
| IWMVideoMediaProps | Gerencia as propriedades de um fluxo de vídeo. |
| IWMWatermarkInfo | Fornece acesso às marcas d'água disponíveis. |
| IWMWriter | Usado como interface principal para escrever arquivos ASF. |
| IWMWriterAdvanced | Fornece funcionalidade avançada para um objeto gravador existente. |
| IWMWriterAdvanced2 | Fornece algumas funcionalidades avançadas, particularmente para lidar com vídeo desentrelaçado. |
| IWMWriterAdvanced3 | Fornece métodos para estatísticas detalhadas do gravador. |
| IWMWriterFileSink | Gerencia um objeto de coletor de arquivos. |
| IWMWriterFileSink2 | Fornece gerenciamento estendido de um objeto de coletor de arquivos. |
| IWMWriterFileSink3 | Amplia ainda mais a funcionalidade do objeto do coletor de arquivos. |
| IWMWriterNetworkSink | Gerencia um objeto de coletor de rede. |
| IWMWriterPostView | Gerencia a saída de amostras do gravador. Usado para verificar o conteúdo codificado de um arquivo durante o processo de codificação. |
| IWMWriterPostViewCallback | Implementado pelo aplicativo para receber amostras de postview do escritor. |
| IWMWriterPreprocess | Gerencia as configurações de codificação multipassagem. |
| IWMWriterPushSink | Gerencia um objeto de coletor de push. |
| IWMWriterSink | Gerencia a entrada bruta do Windows Media Format a partir das interfaces do gravador. Usado como uma interface base para as outras interfaces de coletor do gravador. |
A tabela a seguir mostra a herança de cada interface e os objetos dos quais uma instância pode ser obtida.
| Interface | Herda de | Objetos |
|---|---|---|
| INSNetSourceCreator | IUnknown | Objeto do criador do código-fonte |
| INSSBuffer | IUnknown | objeto de buffer |
| INSSBuffer2 | INSSBuffer | objeto de buffer |
| INSSBuffer3 | INSSBuffer2 | objeto de buffer |
| INSSBuffer4 | INSSBuffer3 | objeto de buffer |
| IReferenceClock | IUnknown | Objeto Reader |
| IWMAddressAccess | IUnknown | de objetos do coletor de rede do Writer |
| IWMAddressAccess2 | IWMAddressAccess | de objetos do coletor de rede do Writer |
| IWMBackupRestoreProps | IUnknown | do objeto restaurador de backup |
| IWMBandwidthSharing | IWMStreamList | de objetos de compartilhamento de largura de banda |
| IWMClientConnections | IUnknown | de objetos do coletor de rede do Writer |
| IWMClientConnections2 | IWMClientConnections | de objetos do coletor de rede do Writer |
| IWMCodecAMVideoAccelerator | IUnknown | Descodificador do Windows Media DMO |
| IWMCodecInfo | IUnknown | de objetos do Gerenciador de Perfis |
| IWMCodecInfo2 | IWMCodecInfo | de objetos do Gerenciador de Perfis |
| IWMCodecInfo3 | IWMCodecInfo2 | de objetos do Gerenciador de Perfis |
| IWMCredentialCallback | IUnknown | Implementado pela aplicação |
| IWMDRMEditor | IUnknown | Objeto do Editor de Metadados |
| IWMDRMReader | IUnknown | Objeto Reader |
| IWMDRMWriter | IUnknown | do objeto Writer |
| IWMHeaderInfo | IUnknown | Objeto Editor de Metadados, Reader Object, Synchronous Reader Object, Writer Object |
| IWMHeaderInfo2 | IWMHeaderInfo | Objeto Editor de Metadados, Reader Object, Synchronous Reader Object, Writer Object |
| IWMHeaderInfo3 | IWMHeaderInfo2 | Objeto Editor de Metadados, Reader Object, Synchronous Reader Object, Writer Object |
| IWMImageInfo | IUnknown | Objeto Editor de Metadados, Reader ObjectSynchronous Reader Object |
| IWMIndexer | IUnknown | objeto indexador |
| IWMIndexer2 | IWMIndexer | objeto indexador |
| IWMInputMediaProps | IWMMediaProps | de objeto de propriedades de mídia de entrada |
| IWMIStreamProps | IUnknown | Objeto Stream (IStream) |
| IWMLanguageList | IUnknown | de objeto de perfil, de objeto do Editor de Metadados , de objeto Reader, de objeto de leitor síncrono, de objeto do Writer |
| IWMLicenseBackup | IUnknown | do objeto restaurador de backup |
| IWMLicenseRestore | IUnknown | do objeto restaurador de backup |
| IWMMediaProps | IUnknown | Input Media Properties Object, Output Media Properties Object, Stream Configuration Object |
| IWMMetadataEditor | IUnknown | Objeto do Editor de Metadados |
| IWMMetadataEditor2 | IWMMetadataEditor | Objeto do Editor de Metadados |
| IWMMutualExclusion | IWMStreamList | Objeto de exclusão mútua |
| IWMMutualExclusion2 | IWMMutualExclusion | Objeto de exclusão mútua |
| IWMOutputMediaProps | IUnknown | de objeto de propriedades de mídia de saída |
| IWMPacketSize | IUnknown | de objetos do Gerenciador de Perfis |
| IWMPacketSize2 | IWMPacketSize | de objetos do Gerenciador de Perfis |
| IWMPlayerHook | IUnknown | Implementado pela aplicação |
| IWMPlayerTimestampHook | IUnknown | Filtro de origem |
| IWMProfile | IUnknown | de objeto de perfil |
| IWMProfile2 | IWMProfile | de objeto de perfil |
| IWMProfile3 | IWMProfile2 | de objeto de perfil |
| IWMProfileManager | IUnknown | de objetos do Gerenciador de Perfis |
| IWMProfileManager2 | IWMProfileManager | de objetos do Gerenciador de Perfis |
| IWMProfileManagerLanguage | IUnknown | de objetos do Gerenciador de Perfis |
| IWMPropertyVault | IUnknown | Stream Configuration Object |
| IWMReader | IUnknown | Objeto Reader |
| IWMReaderAccelerator | IUnknown | Objeto Reader |
| IWMReaderAdvanced | IUnknown | Objeto Reader |
| IWMReaderAdvanced2 | IWMReaderAdvanced | Objeto Reader |
| IWMReaderAdvanced3 | IWMReaderAdvanced2 | Objeto Reader |
| IWMReaderAdvanced4 | IWMReaderAdvanced3 | Objeto Reader |
| IWMReaderAllocatorEx | IUnknown | Implementado pela aplicação |
| IWMReaderCallback | IWMStatusCallback | Implementado pela aplicação |
| IWMReaderCallbackAdvanced | IUnknown | Implementado pela aplicação |
| IWMReaderNetworkConfig | IUnknown | Objeto Reader |
| IWMReaderNetworkConfig2 | IWMReaderNetworkConfig | Objeto Reader |
| IWMReaderStreamClock | IUnknown | Objeto Reader |
| IWMReaderTimecode | IUnknown | Objeto Reader |
| IWMReaderTypeNegotiation | IUnknown | Objeto Reader |
| IWMRegisterCallback | IUnknown | Implementado pela aplicação |
| IWMSBufferAllocator | IUnknown | Implementado por um servidor de rede |
| IWMSInternalAdminNetSource | IUnknown | Objeto do administrador da fonte de rede |
| IWMSInternalAdminNetSource2 | IWMSInternalAdminNetSource | Objeto do administrador da fonte de rede |
| IWMSInternalAdminNetSource3 | IWMSInternalAdminNetSource2 | Objeto do administrador da fonte de rede |
| IWMStatusCallback | IUnknown | Implementado pela aplicação |
| IWMStreamConfig | IUnknown | Stream Configuration Object |
| IWMStreamConfig2 | IWMStreamConfig | Stream Configuration Object |
| IWMStreamConfig3 | IWMStreamConfig2 | Stream Configuration Object |
| IWMStreamList | IUnknown | de objeto de compartilhamento de largura de banda, objeto de exclusão mútua |
| IWMStreamPrioritization | IUnknown | Objeto de priorização de fluxo |
| IWMSyncReader | IUnknown | de objeto de leitor síncrono |
| IWMSyncReader2 | IWMSyncReader | de objeto de leitor síncrono |
| IWMVideoMediaProps | IWMMediaProps | Stream Configuration Object |
| IWMWatermarkInfo | IUnknown | do objeto Writer |
| IWMWriter | IUnknown | do objeto Writer |
| IWMWriterAdvanced | IUnknown | do objeto Writer |
| IWMWriterAdvanced2 | IWMWriterAdvanced | do objeto Writer |
| IWMWriterAdvanced3 | IWMWriterAdvanced2 | do objeto Writer |
| IWMWriterFileSink | IWMWriterSink | Writer File Sink Object |
| IWMWriterFileSink2 | IWMWriterFileSink | Writer File Sink Object |
| IWMWriterFileSink3 | IWMWriterFileSink2 | Writer File Sink Object |
| IWMWriterNetworkSink | IWMWriterSink | de objetos do coletor de rede do Writer |
| IWMWriterPostView | IUnknown | do objeto Writer |
| IWMWriterPostViewCallback | IUnknown | Implementado pela aplicação |
| IWMWriterPreprocess | IUnknown | do objeto Writer |
| IWMWriterPushSink | IWMWriterSink | Writer Push Sink Object |
| IWMWriterSink | IUnknown | Writer File Sink Object, Writer Network Sink Object, Writer Push Sink Object |
Comentários
O identificador de interface para cada uma das interfaces neste SDK é o nome da interface precedido por "IID_". Por exemplo, o identificador da interface IWMReaderAdvanced é IID_IWMReaderAdvanced. Para obter um ponteiro para a interface IWMReaderAdvanced de um objeto reader, use o código a seguir, onde pReader é um ponteiro para uma interface IWMReader:
IWMReaderAdvanced *pReaderAdvanced;
hr = pReader->QueryInterface(IID_IWMReaderAdvanced,
(LPVOID*) &pReaderAdvanced);
Tópicos relacionados