Partilhar via

Guardar conteúdo

[A funcionalidade associada a esta página, Windows Media Format 11 SDK, é uma funcionalidade herdada. Foi substituído por Source Reader e Sink Writer. O do Source Reader e o do Sink Writer foram otimizados para o Windows 10 e o Windows 11. A Microsoft recomenda vivamente que o novo código utilize Leitor de Fonte e Gravador de Sink em vez do Windows Media Format 11 SDK, 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.]

Usando esse SDK, um aplicativo pode salvar o conteúdo baixado ou transmitido para o computador local do usuário, chamando o IWMReaderAdvanced2::SaveFileAs método no objeto reader. Para conteúdo transmitido, o servidor deve estar usando a transmissão de Cache Rápido, que é descrita na seção Habilitando a transmissão de Cache Rápido a partir 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 lista de reprodução 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 conteúdo em um arquivo local, faça o seguinte:

  1. Chame IWMReader::Open usando o URL. Open é 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.
  2. Consulte o objeto leitor para a interface IWMReaderAdvanced4.
  3. Verifique se o conteúdo pode ser salvo chamando o IWMReaderAdvanced4::CanSaveFileAs método. Se o método retornar False, o conteúdo não poderá ser salvo localmente. Caso contrário, avance para o passo 4.
  4. Chame o método de IWMReaderAdvanced4::IsUsingFastCache para determinar se o servidor está usando streaming de cache rápido.
  5. Chame o 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 IWMReaderAdvanced4::CancelSaveFileAs método.

O conteúdo guardado pode estar protegido com DRM, pelo que poderá não ser possível reproduzir o ficheiro noutro computador. Para obter mais informações sobre proteção de conteúdo, consulte Recursos de gerenciamento de direitos digitais.

Interface IWMReader

Interface IWMReaderAdvanced2

 

 

  • Last updated on