Метод 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, чтобы разблокировать хранилище атрибутов.
Этот интерфейс доступен на следующих платформах, если установлены распространяемые компоненты пакета 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).

Требования

Требование Значение
Минимальная версия клиента Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header mfobjects.h (включая Mfidl.h)
Библиотека Mfuuid.lib

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

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

IMFAttributes