Salvar conteúdo
[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.]
Usando esse SDK, um aplicativo pode salvar conteúdo baixado ou transmitido para o computador local do usuário, chamando o método IWMReaderAdvanced2::SaveFileAs no objeto reader. Para conteúdo transmitido, o servidor deve estar usando o streaming de Cache Rápido, que é descrito na seção Habilitando o streaming de cache rápido do cliente. Para conteúdo transmitido, o método SaveFileAs cria um arquivo ASX que aponta para um arquivo ASF que contém o conteúdo salvo. Se o objeto leitor estiver transmitindo uma playlist do lado do servidor, cada entrada será salva como um arquivo ASF separado e o arquivo ASX apontará para cada um dos arquivos ASF. Para conteúdo baixado, o método SaveFileAs simplesmente cria um arquivo ASF.
Para salvar o conteúdo em um arquivo local, faça o seguinte:
- Chame IWMReader::Open com a URL. Abrir é uma chamada assíncrona e retorna imediatamente. Aguarde a conclusão da operação, conforme descrito em Para criar um leitor e abrir um arquivo.
- Consulte o objeto reader para a interface IWMReaderAdvanced4 .
- Verifique se o conteúdo pode ser salvo chamando o método IWMReaderAdvanced4::CanSaveFileAs . Se o método retornar False, o conteúdo não poderá ser salvo localmente. Caso contrário, vá para a etapa 4.
- Chame o método IWMReaderAdvanced4::IsUsingFastCache para determinar se o servidor está usando streaming de Cache Rápido.
- Chame iWMReaderAdvanced2::SaveFileAs com um nome de arquivo para o arquivo local. Se o método IsUsingFastCache retornou True, dê ao nome do arquivo uma extensão .asx. Caso contrário, dê ao nome do arquivo uma extensão .asf, .wma ou .wmv.
O aplicativo pode cancelar a operação de salvamento enquanto ela está em andamento, chamando o método IWMReaderAdvanced4::CancelSaveFileAs .
O conteúdo salvo pode estar protegido com DRM, portanto, talvez não seja possível reproduzir o arquivo em outro computador. Para obter mais informações sobre proteção de conteúdo, consulte Recursos do Gerenciamento de Direitos Digitais.
Tópicos relacionados