Поделиться через


Метод 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
Указанный ключ не найден.

Комментарии

Этот интерфейс доступен на следующих платформах, если установлены распространяемые компоненты пакета SDK для Windows Media Format 11:

  • Windows XP с пакетом обновления 2 (SP2) и более поздних версий.
  • Windows XP Media Center Edition 2005 с установленным KB900325 (Windows XP Media Center Edition 2005) и KB925766 (накопительный пакет обновления за октябрь 2006 г. для Windows XP Media Center Edition).

Примеры

В следующем примере атрибут копируется из одного хранилища атрибутов в другое.

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
Header mfobjects.h (включая Mfidl.h)
Библиотека Mfuuid.lib

См. также раздел

Атрибуты и свойства

IMFAttributes