IMFAttributes 介面 (mfobjects.h)

提供在 物件上儲存索引鍵/值組的一般方式。 索引鍵為 GUID，而且這些值可以是下列任何資料類型： UINT32、 UINT64、 double、 GUID、寬字元字串、位元組陣列或 IUnknown 指標。 這個介面的標準實作會在新增、刪除或擷取值時保留執行緒鎖定。

如需預先定義屬性 GUID的清單，請參閱 媒體基礎屬性。 每個屬性 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 將雙精度浮點數與索引鍵產生關聯。
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 with Service Pack 2 (SP2) 和更新版本。
• 已安裝 Windows XP Media Center 版本 2005 200325 (Windows XP Media Center Edition 2005) 和 KB925766 (2006 年 10 月 Windows XP Media Center Edition 更新彙總套件) 。

需求

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

另請參閱

屬性和屬性

媒體基礎介面