Metodo IMFCollection::GetElement (mfobjects.h)

Articolo
03/05/2024

Recupera un oggetto nell'insieme.

Sintassi

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

Parametri

[in] dwElementIndex

Indice in base zero dell'oggetto da recuperare. Gli oggetti vengono indicizzati nell'ordine in cui sono stati aggiunti all'insieme.

[out] ppUnkElement

Riceve un puntatore all'interfaccia IUnknown dell'oggetto. Il chiamante deve rilasciare l'interfaccia. Il valore del puntatore recuperato potrebbe essere NULL.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo non rimuove l'oggetto dall'insieme. Per rimuovere un oggetto, chiamare FMCollection::RemoveElement.

Esempio

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	mfobjects.h (include Mfidl.h)
Libreria	Mfuuid.lib

Vedi anche

FMICollection

Condividi tramite