다음을 통해 공유

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

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 mfobjects.h(Mfidl.h 포함)
라이브러리 Mfuuid.lib

추가 정보

IMFCollection