IMFAttributes：：GetItemByIndex 方法 (mfobjects.h)

  • 發行項

擷取位於指定索引處的屬性。

語法

HRESULT GetItemByIndex(
  [in]      UINT32      unIndex,
  [out]     GUID        *pguidKey,
  [in, out] PROPVARIANT *pValue
);

參數

[in] unIndex

要擷取的屬性索引。 若要取得屬性數目，請呼叫 IMFAttributes：：GetCount。

[out] pguidKey

接收識別這個屬性的 GUID。

[in, out] pValue

接收值的 PROPVARIANT 指標。 此參數可以是 Null。 如果不是 NULL，此方法會以屬性值的複本填入 PROPVARIANT 。 呼叫 PropVariantClear 以釋放此方法配置的記憶體。

傳回值

方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼 描述
S_OK
 此方法已成功。
E_INVALIDARG
 索引無效。

備註

若要以安全線程的方式列舉物件的所有屬性，請執行下列動作：

  1. 呼叫 IMFAttributes：：LockStore 以防止另一個線程新增或刪除屬性。
  2. 呼叫 IMFAttributes：：GetCount 以尋找屬性數目。
  3. 呼叫 GetItemByIndex 依索引取得每個屬性。
  4. 呼叫 IMFAttributes：：UnlockStore 以解除鎖定屬性存放區。
如果已安裝 Windows Media Format 11 SDK 可轉散發元件，此介面可在下列平臺上使用：
  • Windows XP with Service Pack 2 (SP2) 和更新版本。
  • 已安裝 Windows XP Media Center Edition 2005 KB900325 (Windows XP Media Center 版本 2005) 和 KB925766 (2006 年 10 月更新匯總) 。

規格需求

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

另請參閱

屬性和屬性

IMFAttributes