IMFCollection::GetElement メソッド (mfobjects.h)

コレクション内のオブジェクトを取得します。

構文

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

パラメーター

[in] dwElementIndex

取得するオブジェクトの 0 から始まるインデックス。 オブジェクトは、コレクションに追加された順序でインデックスが作成されます。

[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;
}

要件

こちらもご覧ください

IMFCollection