Méthode IMFCollection ::GetElement (mfobjects.h)

Article
02/28/2024

Récupère un objet dans la collection.

Syntaxe

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

Paramètres

[in] dwElementIndex

Index de base zéro de l’objet à récupérer. Les objets sont indexés dans l’ordre dans lequel ils ont été ajoutés à la collection.

[out] ppUnkElement

Reçoit un pointeur vers l’interface IUnknown de l’objet. L’appelant doit libérer l’interface. La valeur du pointeur récupérée peut être NULL.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Cette méthode ne supprime pas l’objet de la collection. Pour supprimer un objet, appelez IMFCollection ::RemoveElement.

Exemples

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	mfobjects.h (include Mfidl.h)
Bibliothèque	Mfuuid.lib

Voir aussi

IMFCollection

Partager via