Метод IMFCollection::GetElement (mfobjects.h)

  • Статья

Извлекает объект в коллекции.

Синтаксис

HRESULT GetElement(
  [in]  DWORD    dwElementIndex,
  [out] IUnknown **ppUnkElement
);

Параметры

[in] dwElementIndex

Отсчитываемый от нуля индекс извлекаемого объекта. Объекты индексируются в том порядке, в котором они были добавлены в коллекцию.

[out] ppUnkElement

Получает указатель на интерфейс IUnknown объекта. Вызывающий объект должен освободить интерфейс . Полученное значение указателя может иметь значение NULL.

Возвращаемое значение

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Этот метод не удаляет объект из коллекции. Чтобы удалить объект, вызовите IMFCollection::RemoveElement.

Примеры

//  Gets an interface pointer from a collection (IMFCollection).
//
//  Q: Interface type

template <class Q>
HRESULT GetCollectionObject(IMFCollection *pCollection, 
    DWORD dwIndex, Q **ppObject)
{
    *ppObject = NULL;   // zero output

    IUnknown *pUnk = NULL;
    HRESULT hr = pCollection->GetElement(dwIndex, &pUnk);
    if (SUCCEEDED(hr))
    {
        hr = pUnk->QueryInterface(IID_PPV_ARGS(ppObject));
        pUnk->Release();
    }
    return hr;
}

Требования

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

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

IMFCollection