IMFAttributes::SetItem メソッド (mfobjects.h)

指定したキーを持つ属性値を追加します。

構文

HRESULT SetItem(
  [in] REFGUID        guidKey,
  [in] REFPROPVARIANT Value
);

パラメーター

[in] guidKey

設定する値を識別する GUID。 このキーが既に存在する場合、メソッドは古い値を上書きします。

[in] Value

属性値を含む PROPVARIANT 。 メソッドは値をコピーします。 PROPVARIANT 型は、MF_ATTRIBUTE_TYPE列挙にリストされている型のいずれかである必要があります。

戻り値

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

注釈

このメソッドは 、PROPVARIANT 型が MF_ATTRIBUTE_TYPEで定義されている属性型の 1 つであるかどうかを確認し、サポートされていない型が使用されている場合は失敗します。 ただし、このメソッドは、PROPVARIANT が指定した属性 GUID の正しい型であるかどうかをチェックしません。 (属性 GUID をプロパティ型に関連付けるプログラムによる方法はありません。Media Foundation 属性とそのデータ型の一覧については、「 Media Foundation 属性」を参照してください。

このインターフェイスは、Windows Media Format 11 SDK 再頒布可能コンポーネントがインストールされている場合、次のプラットフォームで使用できます。

• Windows XP Service Pack 2 (SP2) 以降。
• Windows XP Media Center Edition 2005 KB900325 (Windows XP Media Center Edition 2005) とKB925766 (2006 年 10 月 Windows XP Media Center Edition の更新プログラムのロールアップ) がインストールされています。

要件

こちらもご覧ください

属性とプロパティ

IMFAttributes