Сохранение содержимого

[Функция, связанная с этой страницей, Windows Media Format 11 SDK, является устаревшей функцией. Он был заменен средства чтения источника и записи приемника. Source Reader и Sink Writer оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует в новом коде, когда это возможно, использовать Source Reader и Sink Writer вместо Windows Media Format 11 SDK. Корпорация Майкрософт предлагает, что существующий код, использующий устаревшие API, будет перезаписан для использования новых API, если это возможно.]

С помощью этого пакета SDK приложение может сохранить скачанный или потоковый контент на локальный компьютер пользователя, вызвав метод IWMReaderAdvanced2::SaveFileAs в объекте чтения. Для потокового содержимого сервер должен использовать Fast Cache потоковую передачу, которая описана в разделе Включение потоковой передачи Fast Cache на клиенте. Для потокового содержимого метод SaveFileAs создает ASX-файл, указывающий на ASF-файл, содержащий сохраненное содержимое. Если объект чтения осуществляет потоковую передачу списка воспроизведения на сервере, каждая запись сохраняется как отдельный файл ASF, и файл ASX указывает на каждый из файлов ASF. Для загруженного содержимого метод SaveFileAs просто создает ASF-файл.

Чтобы сохранить содержимое в локальный файл, сделайте следующее:

1. Вызовите IWMReader::Open с URL-адресом. Open является асинхронным вызовом и возвращается немедленно. Дождитесь завершения операции, как описано в разделе Создание средства чтения и открытиефайла.
2. Запросите объект чтения для интерфейса IWMReaderAdvanced4.
3. Проверьте, можно ли сохранить содержимое, вызвав метод IWMReaderAdvanced4::CanSaveFileAs. Если метод возвращает false, содержимое не может быть сохранено локально. В противном случае перейдите к шагу 4.
4. Вызовите метод IWMReaderAdvanced4::IsUsingFastCache, чтобы определить, использует ли сервер быструю потоковую передачу кэша.
5. Вызовите IWMReaderAdvanced2::SaveFileAs с именем файла для локального файла. Если метод IsUsingFastCache возвращает значение True, добавьте к имени файла расширение .asx. В противном случае присвойте файлу имя расширения .asf, .wma или .wmv.

Приложение может отменить операцию сохранения во время выполнения, вызвав метод IWMReaderAdvanced4::CancelSaveFileAs.

Сохраненное содержимое может быть защищено с помощью DRM, поэтому может быть невозможно воспроизвести файл на другом компьютере. Дополнительные сведения о защите содержимого см. в разделе функции цифрового управления правами.

Связанные разделы

интерфейса IWMReader

интерфейс IWMReaderAdvanced2