IMFAttributes：：GetItem 方法 (mfobjects.h)

擷取與索引鍵相關聯的值。

語法

HRESULT GetItem(
  [in]      REFGUID     guidKey,
  [in, out] PROPVARIANT *pValue
);

參數

[in] guidKey

GUID，識別要擷取的值。

[in, out] pValue

接收值的 PROPVARIANT 指標。 如果找到值，此方法會以預存值的複本填滿 PROPVARIANT 。 呼叫 PropVariantClear 以釋放此方法配置的記憶體。 此參數可以是 Null。 如果此參數為 NULL，則方法會搜尋索引鍵，並在找到索引鍵時傳回S_OK，但不會複製值。

傳回值

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

傳回碼	描述
S_OK	此方法已成功。
MF_E_ATTRIBUTENOTFOUND	找不到指定的索引鍵。

備註

如果已安裝 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 月更新匯總) 。

範例

下列範例會將屬性從一個屬性存放區複製到另一個存放區。

HRESULT CopyAttribute(IMFAttributes *pFrom, IMFAttributes *pTo, REFGUID guidKey)
{
    PROPVARIANT val;

    HRESULT hr = pFrom->GetItem(guidKey, &val);

    if (SUCCEEDED(hr))
    {
        hr = pTo->SetItem(guidKey, val);
        PropVariantClear(&val);
    }
    else if (hr == MF_E_ATTRIBUTENOTFOUND)
    {
        hr = S_OK;
    }
    return hr;
}

規格需求

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

另請參閱

屬性和屬性

IMFAttributes