IMFAttributes インターフェイス (mfobjects.h)
オブジェクトにキーと値のペアを格納する一般的な方法を提供します。 キーは GUIDです。値には、 UINT32、 UINT64、 double、 GUID、ワイド文字列、バイト配列、または IUnknown ポインターのいずれかのデータ型を指定できます。 このインターフェイスの標準実装では、値の追加、削除、または取得中にスレッド ロックが保持されます。
定義済みの属性 GUIDの一覧については、「 Media Foundation 属性」を参照してください。 各属性 GUID には、想定されるデータ型があります。 IMFAttributes のさまざまな "set" メソッドは、属性 GUID に対して型を検証しません。 属性の正しい型を設定するのは、アプリケーションの責任です。
空の属性ストアを作成するには、 MFCreateAttributes を呼び出します。
継承
IMFAttributes インターフェイスは IUnknown インターフェイスから継承されます。 IMFAttributes には、 次の種類のメンバーもあります。
メソッド
IMFAttributes インターフェイスには、これらのメソッドがあります。
| IMFAttributes::Compare このオブジェクトの属性を別のオブジェクトの属性と比較します。 |
| IMFAttributes::CompareItem 格納されている属性値が指定した PROPVARIANT と等しいかどうかを照会します。 |
| IMFAttributes::CopyAllItems このオブジェクトからすべての属性を別の属性ストアにコピーします。 |
| IMFAttributes::D eleteAllItems オブジェクトの属性リストからすべてのキーと値のペアを削除します。 |
| IMFAttributes::D eleteItem オブジェクトの属性リストからキーと値のペアを削除します。 |
| IMFAttributes::GetAllocatedBlob キーに関連付けられているバイト配列を取得します。 このメソッドは、配列のメモリを割り当てます。 |
| IMFAttributes::GetAllocatedString キーに関連付けられたワイド文字列を取得します。 このメソッドは、文字列のメモリを割り当てます。 |
| IMFAttributes::GetBlob キーに関連付けられているバイト配列を取得します。 このメソッドは、呼び出し元によって割り当てられたバッファーに配列をコピーします。 |
| IMFAttributes::GetBlobSize キーに関連付けられているバイト配列の長さを取得します。 |
| IMFAttributes::GetCount このオブジェクトに設定されている属性の数を取得します。 |
| IMFAttributes::GetDouble キーに関連付けられている二重値を取得します。 |
| IMFAttributes::GetGUID キーに関連付けられている GUID 値を取得します。 |
| IMFAttributes::GetItem キーに関連付けられている値を取得します。 |
| IMFAttributes::GetItemByIndex 指定したインデックス位置にある属性を取得します。 |
| IMFAttributes::GetItemType キーに関連付けられている値のデータ型を取得します。 |
| IMFAttributes::GetString キーに関連付けられているワイド文字列を取得します。 |
| IMFAttributes::GetStringLength キーに関連付けられている文字列値の長さを取得します。 |
| IMFAttributes::GetUINT32 キーに関連付けられている UINT32 値を取得します。 |
| IMFAttributes::GetUINT64 キーに関連付けられている UINT64 値を取得します。 |
| IMFAttributes::GetUnknown キーに関連付けられているインターフェイス ポインターを取得します。 |
| IMFAttributes::LockStore 他のスレッドがアクセスできないように属性ストアをロックします。 |
| IMFAttributes::SetBlob バイト配列をキーに関連付けます。 |
| IMFAttributes::SetDouble double 値をキーに関連付けます。 |
| IMFAttributes::SetGUID GUID 値をキーに関連付けます。 |
| IMFAttributes::SetItem 指定したキーを持つ属性値を追加します。 |
| IMFAttributes::SetString ワイド文字列をキーに関連付けます。 |
| IMFAttributes::SetUINT32 UINT32 値をキーに関連付けます。 |
| IMFAttributes::SetUINT64 UINT64 値をキーに関連付けます。 |
| IMFAttributes::SetUnknown IUnknown ポインターをキーに関連付けます。 |
| IMFAttributes::UnlockStore IMFAttributes::LockStore メソッドの呼び出し後に属性ストアのロックを解除します。 オブジェクトのロックが解除されている間、複数のスレッドがオブジェクトの属性にアクセスできます。 |
解説
このインターフェイスは、Windows Media Format 11 SDK 再頒布可能コンポーネントがインストールされている場合、次のプラットフォームで使用できます。
- Service Pack 2 (SP2) 以降の Windows XP。
- KB900325 (Windows XP Media Center Edition 2005) と KB925766 (2006 年 10 月 Windows XP Media Center Edition の更新プログラムロールアップ) がインストールされている Windows XP Media Center Edition 2005。
要件
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ | UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリ | UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | mfobjects.h (Mfidl.h を含む) |