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中定義的其中一個屬性類型，如果使用不支援的類型，則失敗。 不過，這個方法不會檢查 PROPVARIANT 是否為指定屬性 GUID 的正確類型。 (沒有程序設計方式可將屬性 GUID 與屬性類型產生關聯。) 如需 Media Foundation 屬性及其數據類型的清單，請參閱 Media Foundation 屬性。

如果已安裝 Windows Media Format 11 SDK 可轉散發元件，此介面可在下列平臺上使用：

  • Windows XP with 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 2005。

規格需求

需求 值
最低支援的用戶端 Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 mfobjects.h (包含 Mfidl.h)
程式庫 Mfuuid.lib

另請參閱

屬性和屬性

IMFAttributes