IMFCollection::GetElement-Methode (mfobjects.h)

Ruft ein Objekt in der Auflistung ab.

Syntax

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

Parameter

[in] dwElementIndex

Nullbasierter Index des abzurufenden Objekts. Objekte werden in der Reihenfolge indiziert, in der sie der Auflistung hinzugefügt wurden.

[out] ppUnkElement

Empfängt einen Zeiger auf die IUnknown-Schnittstelle des Objekts. Der Aufrufer muss die Schnittstelle freigeben. Der abgerufene Zeigerwert kann NULL sein.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode entfernt das -Objekt nicht aus der Auflistung. Um ein Objekt zu entfernen, rufen Sie IMFCollection::RemoveElement auf.

Beispiele

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

Anforderungen

Weitere Informationen

IMFCollection