Arquivos de biblioteca e configurações do compilador
[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.]
Para desenvolver um aplicativo usando o SDK do Windows Media Format, você deve usar Microsoft Visual C++ versão 6.0 ou posterior. As únicas linguagens de programação apropriadas para desenvolvimento são C++ e C.
O conteúdo dos vários arquivos de cabeçalho incluídos com esse SDK é descrito na tabela a seguir.
| Arquivo de cabeçalho | Descrição |
|---|---|
| asferr.h | Define códigos de erro relacionados a operações de arquivo ASF. Esse cabeçalho está incluído em wmsdk.h. |
| drmexternals.h | Define estruturas, enumerações e constantes usadas para DRM (gerenciamento de direitos digitais). Inclua esse cabeçalho ao escrever um aplicativo que usa DRM. |
| dshowasf.h | Define os filtros de QASF do Microsoft DirectShow. Inclua esse cabeçalho ao escrever um aplicativo DirectShow que cria ou lê arquivos ASF. Para obter mais informações, consulte DirectShow e Windows Media. |
| msnetobj.h | Define a interface IRMGetLicense , que é implementada em uma das bibliotecas de runtime instaladas com o SDK do Formato de Mídia do Windows. |
| nserror.h | Define códigos de erro para Tecnologias de Mídia do Windows. Somente um subconjunto desses códigos de erro é relevante para o SDK do Windows Media Format. Esse cabeçalho está incluído em wmsdk.h. |
| wmdxva.h | Inclui outros cabeçalhos e definições necessários para habilitar a Aceleração de Vídeo do Microsoft DirectX para reprodução de conteúdo baseado em Windows Media. Para obter mais informações, consulte Habilitando a aceleração de vídeo do DirectX. |
| wmnetsourcecreator.h | Contém informações necessárias para criar plug-ins de origem de rede. |
| wmsbuffer.h | Define as interfaces usadas por objetos de buffer. Inclua esse cabeçalho ao criar seus próprios buffers para leitura de arquivo. |
| wmsdk.h | O cabeçalho main para aplicativos que usam o SDK do Windows Media Format. Esse cabeçalho não contém definições, mas inclui asferr.h, nserror.h, windows.h e wmsdkidl.h. Inclua esse cabeçalho para todos os aplicativos usando esse SDK. |
| wmsdkidl.h | Define as interfaces, as funções, as estruturas, as enumerações e as constantes para a maioria dos objetos do SDK do Windows Media Format. Esse cabeçalho está incluído em wmsdk.h. |
| wmsinternaladminnetsource.h | Define as interfaces dos plug-ins de origem de rede. |
| wmsysprf.h | Define as constantes para os perfis do sistema. Inclua esse cabeçalho em aplicativos que carregam perfis do sistema por identificador. |
Para usar o SDK do Windows Media Format, o compilador deve estar configurado corretamente. A configuração é diferente para compilar no modo de depuração do que para o modo de versão. Defina sua configuração de acordo com a tabela a seguir. Todas essas configurações são definidas na caixa de diálogo Configurações do Projeto. Para acessar a caixa de diálogo, selecione Configurações no menu Projeto .
| Configuração | Valor de depuração | Valor da versão |
|---|---|---|
| (Guia C/C++, Categoria = Geração de Código) Usar biblioteca em tempo de execução | Depurar DLL multithread | DLL multithread |
| (Guia Link, Categoria = Geral) Ignorar todas as bibliotecas padrão (caixa marcar) | Selecionada | Selecionada |
| (Guia Link, Categoria = Geral) Módulos de objeto/biblioteca | Inclua Msvcrtd.lib e Wmvcore.lib.Do não inclua Libc.lib ou qualquer variação. |
Inclua Msvcrt.lib e Wmvcore.lib.Do não inclua Libc.lib ou qualquer variação. |
Se você estiver usando o Microsoft Visual Studio .NET, as configurações foram alteradas para locais diferentes, conforme mostrado na tabela a seguir. Todas essas configurações são definidas na caixa de diálogo Páginas de Propriedades . Para acessar a caixa de diálogo, clique com o botão direito do mouse no projeto no painel Gerenciador de Soluções e selecione Propriedades no menu de contexto.
| Configuração | Valor de depuração | Valor da versão |
|---|---|---|
| (Propriedades de configuração/ C/C++ / Geração de código) Biblioteca de runtime | DLL de depuração de vários threads (/MDd) | DLL com vários threads (/MD) |
| (Propriedades de configuração/Vinculador/Entrada) Dependências adicionais | Inclua Msvcrtd.lib e Wmvcore.lib.Do não inclua Libc.lib ou qualquer variação. |
Inclua Msvcrt.lib e Wmvcore.lib.Do não inclua Libc.lib ou qualquer variação. |
| (Propriedades de configuração/Vinculador/Entrada) Ignorar todas as bibliotecas padrão | Sim | Sim |
Se você quiser atrasar o carregamento de Wmvcore.dll ou qualquer outra DLL, use a opção de link /DELAYLOAD no Microsoft Visual C++ 6.0 ou atrasar DLLs carregadas no Microsoft Visual C++ .NET.
Além disso, você precisa incluir os diretórios para as bibliotecas e cabeçalhos do SDK do Formato de Mídia do Windows. Para localizar as configurações de diretório do Visual C++ 6.0, no menu Ferramentas , clique em Opções e, em seguida, clique na guia Diretórios . Ao usar o Visual C++ .NET, clique em Opções no menu Ferramentas e selecione Projetos/Diretórios VC++ na lista de opções. Adicione diretórios conforme mostrado na tabela a seguir. Se você alterou o diretório de instalação do SDK do Windows Media Format, seu caminho será diferente.
| Tipo de diretório | Caminho padrão |
|---|---|
| Incluir arquivos | C:\WMSDK\WMFSDK11\include |
| Arquivos de biblioteca | C:\WMSDK\WMFSDK11\lib |
Se você estiver usando o SDK da Plataforma, os caminhos padrão aparecerão da seguinte maneira:
| Tipo de diretório | Caminho padrão |
|---|---|
| Incluir arquivos | C:\Arquivos de Programas\Microsoft SDsK\Windows\v6.0\Include |
| Arquivos de biblioteca | C:\Arquivos de Programas\Microsoft SDsK\Windows\v6.0\Lib |
Antes de chamar qualquer uma das funções de criação, COM deve ser inicializado com uma chamada para Coinitialize ou CoinitializeEx. O modelo de threading gratuito ou o modelo de threading apartment podem ser usados, mas o modelo de threading apartment impõe restrições de threading ao aplicativo. Para obter mais informações sobre o COM (Microsoft Component Object Model), consulte a página COM no site da Microsoft.
Nota Os aplicativos que reproduzem ou criam arquivos protegidos pelo DRM (Gerenciamento de Direitos Digitais) exigem uma biblioteca estática individualizada que deve ser obtida separadamente da Microsoft. Para obter mais informações, consulte o Formulário de Licenciamento do Windows Media no site da Microsoft. Se você usar a biblioteca DRM, não deverá vincular ao Wmvcore.lib.