IWMProfile インターフェイス
[このページに関連付けられている機能である Windows Media Format 11 SDK は、レガシ機能です。 これは、ソース リーダーとシンク ライターによって置き換えられます。 ソース リーダーとシンク ライターは、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、Windows Media Format 11 SDK ではなくソース リーダーとシンク ライターを使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]
IWMProfile インターフェイスは、プロファイル オブジェクトのプライマリ インターフェイスです。 プロファイル オブジェクトは、カスタム プロファイルを構成するために使用されます。 IWMProfile を使用して、ストリーム構成オブジェクトと相互排他オブジェクトを作成、削除、または変更できます。 プロファイルに関する一般的な情報を設定および取得することもできます。 プロファイル オブジェクトのすべての機能にアクセスするには、IWMProfile2 と IWMProfile2 から継承する IWMProfile3 を使用する必要があります。
IWMProfile には、リーダー オブジェクトを介してアクセスすることもできます。このオブジェクトを使用して、リーダーに読み込まれたファイルのストリームに関する情報を取得できます。 リーダーから IWMProfile にアクセスする場合は、プロファイルに変更を加えることができますが、ファイルに変更を保存することはできません。 多くの場合、既存のファイルのプロファイルを新しいプロファイルの基礎として使用すると便利です。 同期リーダーは、リーダーと同じ方法で IWMProfile をサポートします。
リーダーまたは同期リーダーを介して取得されたプロファイル情報は、.prx ファイルから取得されません。 リーダーは、ASF ファイル内の情報を使用してストリーム構成をアセンブルします。 したがって、名前や説明などの特定のプロファイル情報は、リーダーからは使用できません。
IWMProfile インターフェイスへのポインターを取得するには、いくつかの方法があります。 プロファイル マネージャーには、新しいプロファイルを作成し、既存のプロファイルにアクセスする方法があります。 これらのメソッドはすべて 、IWMProfile ポインターを設定します。 ファイルを読み取るときに、任意のリーダー インターフェイスの QueryInterface メソッドを呼び出すことによって、IWMProfile へのポインターを取得できます。 同様に、同期リーダー オブジェクトのインターフェイスは、 QueryInterfaceIWMProfile3 の呼び出しでポインターを取得できます。
メンバー
IWMProfile インターフェイスは、IUnknown インターフェイスから継承されます。 IWMProfile には、次の種類のメンバーもあります。
メソッド
IWMProfile インターフェイスには、これらのメソッドがあります。
| メソッド | 説明 |
|---|---|
| AddMutualExclusion | プロファイルに相互除外オブジェクトを追加します。 |
| AddStream | プロファイルにストリームを追加します。 |
| CreateNewMutualExclusion | プロファイルの相互除外オブジェクトを作成します。 |
| CreateNewStream | プロファイルのストリーム構成オブジェクトを作成します。 |
| GetDescription | プロファイルの説明を取得します。 |
| GetMutualExclusion | プロファイルから相互除外オブジェクトを取得します。 |
| GetMutualExclusionCount | プロファイル内の相互除外オブジェクトの数を取得します。 |
| GetName | プロファイルの名前を取得します。 |
| Getstream | プロファイルからインデックス番号を使用してストリームを取得します。 |
| GetStreamByNumber | ストリームの数を使用して、プロファイルからストリームを取得します。 |
| GetStreamCount | プロファイル内のストリームの数を取得します。 |
| Getversion | プロファイル内の Microsoft Windows Media Services のバージョン番号を取得します。 |
| ReconfigStream | ストリーム構成に加えられた変更をプロファイルに含めることができます。 |
| RemoveMutualExclusion | プロファイルから相互除外オブジェクトを削除します。 |
| RemoveStream | プロファイルからストリームを削除します。 |
| RemoveStreamByNumber | プロファイルからストリームを削除します。 |
| SetDescription | プロファイルの説明を指定します。 |
| SetName | プロファイルの名前を指定します。 |
このインターフェイスの QueryInterface メソッドを使用して取得できるインターフェイスの詳細については、このインターフェイスが実装されているオブジェクトのトピックを参照してください。