Profile オブジェクト
[このページに関連付けられている機能である Windows Media Format 11 SDK は、レガシ機能です。 これは、ソース リーダーとシンク ライターによって置き換えられます。 ソース リーダーとシンク ライターは、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、Windows Media Format 11 SDK ではなくソース リーダーとシンク ライターを使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]
プロファイル オブジェクトは、プロファイルの設定を管理します。 プロファイル オブジェクトは、既存のプロファイル データ用に作成することも、空にして新しいデータを受信できるように作成することもできます。 プロファイル オブジェクトは、読み取り用にファイルが読み込まれるときに、リーダー オブジェクト (および同期リーダー オブジェクト) によっても作成されます。 この場合、オブジェクトにはファイルのヘッダーに格納されているプロファイル情報が設定されます。
プロファイル オブジェクトの内容を保存するには、 IWMProfileManager::SaveProfile を呼び出す必要があります。
プロファイルには、プロファイルのさまざまな側面 (ストリームなど) を制御する複数のオブジェクトが含まれています。 これらのオブジェクトはすべて、プロファイル オブジェクトに従属します。 この SDK の主要なオブジェクトと同様に、作成関数を使用してこれらのオブジェクトを作成することはありません。 代わりに、プロファイル オブジェクトのインターフェイスには、下位オブジェクトを作成するメソッドが含まれています。
プロファイル オブジェクトを作成するには、次のいずれかのメソッドを呼び出します。
Method | 説明 |
---|---|
IWMProfileManager::CreateEmptyProfile | プロファイル データを含まないプロファイル オブジェクトを作成します。 |
IWMProfileManager::LoadProfileByData | 文字列として保存されたプロファイルのデータが設定されたプロファイル オブジェクトを作成します。 これは、カスタム プロファイルのデータを含むプロファイル オブジェクトを作成する唯一の方法です。 |
IWMProfileManager::LoadProfileByID | システム プロファイルのデータが設定されたプロファイル オブジェクトを作成します。 GUID を使用して、目的のシステム プロファイルを識別します。 |
IWMProfileManager::LoadSystemProfile | システム プロファイルのデータが設定されたプロファイル オブジェクトを作成します。 プロファイル インデックスを使用して、目的のシステム プロファイルを識別します。 |
前の表のすべてのメソッドは、 IWMProfile インターフェイスへのポインターを設定します。 プロファイル オブジェクトの他のインターフェイスは、 QueryInterface メソッドを呼び出すことで取得できます。
次のインターフェイスは、すべてのプロファイル オブジェクトでサポートされています。
インターフェイス | 説明 |
---|---|
IWMLanguageList | ASF ファイルでサポートされている言語の一覧を管理します。 |
IWMPacketSize | ファイル内のパケットの最大サイズを制御します。 |
IWMPacketSize2 | ファイル内のパケットの最小サイズを制御します。 IWMPacketSize のすべてのメソッドを継承します。 |
IWMProfile | プロファイルに含まれる基本設定とオブジェクトを制御します。 |
IWMProfile2 | プロファイルに関連付けられているグローバル一意識別子 (GUID) を取得します。 IWMProfile のすべてのメソッドを継承します。 |
IWMProfile3 | プロファイル内の帯域幅共有とストリームの優先順位付け情報を制御します。 IWMProfile と IWMProfile2 のすべてのメソッドを継承します。 |
関連トピック