Méthode IMFCollection ::GetElement (mfobjects.h)
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour