オブジェクト (Windows Media 形式 11 SDK)
[このページに関連付けられている機能である Windows Media Format 11 SDK は、従来の機能です。 ソース リーダーとシンク ライターに置き換わりました。 ソース リーダーとシンク ライターは、Windows 10とWindows 11用に最適化されています。 Microsoft では、可能であれば、新しいコードで Windows Media Format 11 SDK ではなくソース リーダーとシンク ライターを使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]
Windows Media Format SDK では、いくつかのオブジェクトを使用して、ASF ファイルの読み取り、書き込み、編集、インデックス作成、プロファイルの作成と編集を行います。 各オブジェクトは、多数のインターフェイスをサポートしています。 一部のインターフェイスは、複数のオブジェクトでサポートされています。 このような場合は、 インターフェイスのリファレンス セクションで実装の違いについて説明します。
Windows Media Format SDK のオブジェクトは COM に準拠しています。 開発を容易にするために、すべてのオブジェクトに関連付けられた作成関数またはメソッドがあります。 COM 関数 CoCreateInstance を手動で使用するのではなく、作成関数またはメソッドを使用してオブジェクトを作成する必要があります。
一部のインターフェイスには、 IWMProfile2 や IWMWriter3 などの番号が名前に付加されています。 いずれの場合も、番号付きバージョンは、以前のバージョンのすべてのメソッドを継承し、新しい機能を追加します。
この参照の各オブジェクト ページで、メイン COM オブジェクトに含まれるインターフェイスが最初に一覧表示され、その後にアプリケーションで実装する必要があるコールバック インターフェイスが表示されます。
次の表に、この SDK でサポートされているオブジェクトと、それぞれの機能と、その作成に使用される関数の説明を示します。
| Object | 説明 | 作成関数 |
|---|---|---|
| Backup Restorer | 通常はリムーバブル メディアにライセンスをバックアップし、それらのライセンスを別のコンピューターに復元します。 | WMCreateBackupRestorer |
| デバイス登録 | デバイス登録データベースを管理します。このデータベースには、ネットワーク接続を介して使用できるメディア再生デバイスのエントリが含まれます。 | WMCreateDeviceRegistration |
| DRM Transcryptor | DRM で保護されたメディア データを、Windows Media DRM 10 for Network Devices プロトコルを使用するデバイスに送信できるデータ ストリームに変換します。 | WMCreateDRMTranscryptor |
| インデクサー | ビデオ ストリームを使用したファイルのシークを可能にする ASF ファイルのインデックスを作成します。 | WMCreateIndexer |
| ライセンス失効エージェント | ライセンス失効を管理します。 | WMCreateLicenseRevocationAgent |
| メタデータ エディター | ASF ファイル ヘッダーのメタデータを編集します。 | WMCreateEditor |
| プロファイル マネージャー | プロファイルを作成、読み込み、保存するためのインターフェイスを提供します。 ASF ファイルを書き込むにはプロファイルが必要です。 | WMCreateProfileManager |
| Reader | ASF ファイルを読み取ります。 このオブジェクトは、その操作に非同期呼び出しモデルを使用します。 | WMCreateReader |
| 同期リーダー | 同期呼び出しを使用して ASF ファイルを読み取ります。 | WMCreateSyncReader |
| 作家 | ASF ファイルを書き込みます。 | WMCreateWriter |
| ライター ファイル シンク | ライター オブジェクトによって書き込まれた ASF ファイルを制御します。 | WMCreateWriterFileSink |
| ライター ネットワーク シンク | ライター オブジェクトによって書き込まれた ASF ファイルのライブ ネットワーク ストリーミングを制御します。 | WMCreateWriterNetworkSink |
| ライター プッシュ シンク | 公開サーバーへのストリーミング コンテンツの配信を制御します。 | WMCreateWriterPushSink |
次の表に、他のオブジェクトに依存するオブジェクトの一覧を示します。 これらのオブジェクトは、既存のオブジェクトのメソッドによって作成されます。
| Object | 説明 | 作成方法 |
|---|---|---|
| 帯域幅の共有 | プロファイル内の帯域幅共有情報を管理します。 プロファイルには、複数の帯域幅共有オブジェクトが存在する場合があります。 帯域幅共有オブジェクトを作成する方法は、新しい帯域幅共有オブジェクトを作成するか、既存のオブジェクトにアクセスするかによって異なります。 |
IWMProfile3::CreateNewBandwidthSharingまたは IWMProfile3::GetBandwidthSharing |
| バッファー | メディア サンプルと、関連するデータ ユニット拡張機能が含まれます。 サンプルの書き込みと読み取りの両方に使用されます。 |
IWMWriter::AllocateSampleまたは IWMReaderAllocatorEx::AllocateForOutputEx OR IWMReaderAllocatorEx::AllocateForStreamEx OR サンプル配信のために、リーダー オブジェクトまたは同期リーダー オブジェクトによって自動的に作成されます。 |
| 入力メディアのプロパティ | 入力のプロパティを管理します。 入力ごとに 1 つの入力プロパティ オブジェクトを存在させることができます。 | IWMWriter::GetInputProps |
| 相互排他 | プロファイル内の相互除外情報を管理します。 相互除外の一般的な用途は、複数の言語の複数のビット レート コンテンツとサウンドトラックです。 相互排他オブジェクトを作成する方法は、新しい相互除外オブジェクトを作成するか、既存のオブジェクトにアクセスするかによって異なります。 |
IWMProfile::CreateNewMutualExclusionまたは IWMProfile::GetMutualExclusion |
| 出力メディアのプロパティ | 出力のプロパティを管理します。 出力ごとに 1 つの出力メディア プロパティ オブジェクトを存在させることができます。 これらのオブジェクトは、リーダーまたは同期リーダーによって作成できます |
IWMReader::GetOutputPropsまたは IWMSyncReader::GetOutputProps |
| プロファイル | 操作中のプロファイル内のデータを格納します。 プロファイル オブジェクトは、プロファイルを操作する必要がある場合にいつでも作成されます。 プロファイル オブジェクトを作成する方法は、新しいプロファイルを作成するか、既存のプロファイルにアクセスするかによって異なります。 |
IWMProfileManager::CreateEmptyProfileまたは IWMProfileManager::LoadProfileByData OR IWMProfileManager::LoadProfileByID OR IWMProfileManager::LoadSystemProfile |
| ストリーム構成 | プロファイル内のストリームのプロパティを管理します。 ストリーム構成オブジェクトは、ストリームに関する情報にアクセスする必要がある場合は、いつでもストリーム オブジェクトによって作成されます。 ストリーム構成オブジェクトを作成する方法は、新しいストリームを作成するか、アクセスするか、既存のストリームを作成するかによって異なります。 |
IWMProfile::CreateNewStreamまたは IWMProfile::GetStream OR IWMProfile::GetStreamByNumber |
| ストリームの優先順位付け | プロファイルのストリーム優先度リストを保持します。 使用可能な帯域幅が制限されている場合、ストリームは優先度を上げるために削除されます。 プロファイル内に存在できるストリーム優先度設定オブジェクトは 1 つだけです。 | IWMProfile3::CreateNewStreamPrioritization |