Метод 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 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