Méthode IMFAttributes ::GetItemByIndex (mfobjects.h)

Article
02/28/2024

Récupère un attribut à l’index spécifié.

Syntaxe

HRESULT GetItemByIndex(
  [in]      UINT32      unIndex,
  [out]     GUID        *pguidKey,
  [in, out] PROPVARIANT *pValue
);

Paramètres

[in] unIndex

Index de l’attribut à récupérer. Pour obtenir le nombre d’attributs, appelez IMFAttributes ::GetCount.

[out] pguidKey

Reçoit le GUID qui identifie cet attribut.

[in, out] pValue

Pointeur vers un PROPVARIANT qui reçoit la valeur. Ce paramètre peut être NULL. Si elle n’est pas NULL, la méthode remplit le PROPVARIANT avec une copie de la valeur de l’attribut. Appelez PropVariantClear pour libérer la mémoire allouée par cette méthode.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK
E_INVALIDARG	L’index n’est pas valide.

Remarques

Pour énumérer tous les attributs d’un objet de manière thread-safe, procédez comme suit :

Appelez IMFAttributes ::LockStore pour empêcher un autre thread d’ajouter ou de supprimer des attributs.
Appelez IMFAttributes ::GetCount pour rechercher le nombre d’attributs.
Appelez GetItemByIndex pour obtenir chaque attribut par index.
Appelez IMFAttributes ::UnlockStore pour déverrouiller le magasin d’attributs.

Cette interface est disponible sur les plateformes suivantes si les composants redistribuables du SDK Windows Media Format 11 sont installés :

Windows XP avec Service Pack 2 (SP2) et versions ultérieures.
Windows XP Media Center Edition 2005 avec KB900325 (Windows XP Media Center Edition 2005) et KB925766 (correctif cumulatif d’octobre 2006 pour Windows XP Édition Media Center) installés.

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 (inclure Mfidl.h)
Bibliothèque	Mfuuid.lib

Voir aussi

Attributs et propriétés

IMFAttributes

Partager via