コンテンツの保存
[このページに関連付けられている機能である Windows Media Format 11 SDK は、従来の機能です。 ソース リーダーとシンク ライターに置き換わりました。 ソース リーダーとシンク ライターは、Windows 10とWindows 11用に最適化されています。 Microsoft では、可能であれば、新しいコードで Windows Media Format 11 SDK ではなくソース リーダーとシンク ライターを使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]
この SDK を使用すると、アプリケーションは、リーダー オブジェクトで IWMReaderAdvanced2::SaveFileAs メソッドを呼び出すことによって、ダウンロードまたはストリーミングされたコンテンツをユーザーのローカル コンピューターに保存できます。 ストリーミング コンテンツの場合、サーバーは高速キャッシュ ストリーミングを使用している必要があります。詳細については、「 クライアントからの高速キャッシュ ストリーミングの有効化」セクションで説明されています。 ストリーミング コンテンツの場合、 SaveFileAs メソッドは、保存されたコンテンツを含む ASF ファイルを指す ASX ファイルを作成します。 リーダー オブジェクトがサーバー側のプレイリストをストリーミングしている場合、各エントリは個別の ASF ファイルとして保存され、ASX ファイルは各 ASF ファイルを指します。 ダウンロードしたコンテンツの場合、 SaveFileAs メソッドは ASF ファイルを作成するだけです。
ローカル ファイルにコンテンツを保存するには、次の操作を行います。
- URL を使用して IWMReader::Open を呼び出します。 Open は非同期呼び出しであり、直ちに を返します。 「 リーダーを作成してファイルを開くには」の説明に従って、操作が完了するまで待ちます。
- IWMReaderAdvanced4 インターフェイスのリーダー オブジェクトに対してクエリを実行します。
- IWMReaderAdvanced4::CanSaveFileAs メソッドを呼び出して、コンテンツを保存できるかどうかを確認します。 メソッドが False を返した場合、コンテンツをローカルに保存することはできません。 それ以外の場合は、手順 4 に進みます。
- サーバーが高速キャッシュ ストリーミングを使用しているかどうかを判断するには、 IWMReaderAdvanced4::IsUsingFastCache メソッドを呼び出します。
- ローカル ファイルのファイル名を使用して IWMReaderAdvanced2::SaveFileAs を呼び出します。 IsUsingFastCache メソッドが True を返した場合は、ファイル名に .asx 拡張子を指定します。 それ以外の場合は、ファイル名に .asf、.wma、または .wmv 拡張子を指定します。
アプリケーションは、 IWMReaderAdvanced4::CancelSaveFileAs メソッドを呼び出すことによって、作業中に保存操作を取り消すことができます。
保存されたコンテンツは DRM で保護されている可能性があるため、別のコンピューターでファイルを再生できない可能性があります。 コンテンツ保護の詳細については、「 Digital Rights Management の機能」を参照してください。
関連トピック