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

  • [アーティクル]

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

構文

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

パラメーター

[in] guidKey

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

[in] Value

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

戻り値

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

リターン コード 説明
S_OK
 メソッドが成功しました。
E_OUTOFMEMORY
 メモリ不足です。
MF_E_INVALIDTYPE
 属性の種類が無効です。

注釈

このメソッドは 、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 の更新プログラムのロールアップ) がインストールされています。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ | UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリ | UWP アプリ]
対象プラットフォーム Windows
ヘッダー mfobjects.h (Mfidl.h を含む)
Library Mfuuid.lib

こちらもご覧ください

属性とプロパティ

IMFAttributes