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 キーに関連付けられている double 値を取得します。 |
| 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 再頒布可能コンポーネントがインストールされている場合、次のプラットフォームで使用できます。
- Windows XP Service Pack 2 (SP2) 以降。
- KB900325 (Windows XP Media Center Edition 2005) と KB925766 (Windows XP Media Center Edition の 2006 年 10 月更新プログラムロールアップ) がインストールされている Windows XP Media Center Edition 2005。
要件
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | mfobjects.h (Mfidl.h を含む) |