Interface IMFAttributes (mfobjects.h)
Fournit un moyen générique de stocker des paires clé/valeur sur un objet. Les clés sont des GUIDet les valeurs peuvent être l’un des types de données suivants : UINT32, UINT64, double, GUID, chaîne à caractères larges, tableau d’octets ou pointeur IUnknown . L’implémentation standard de cette interface contient un verrou de thread pendant que les valeurs sont ajoutées, supprimées ou récupérées.
Pour obtenir la liste des GUIDd’attribut prédéfinis, consultez Attributs Media Foundation. Chaque GUID d’attribut a un type de données attendu. Les différentes méthodes « set » dans IMFAttributes ne valident pas le type par rapport au GUID d’attribut. Il incombe à l’application de définir le type correct pour l’attribut.
Pour créer un magasin d’attributs vide, appelez MFCreateAttributes.
Héritage
L’interface IMFAttributes hérite de l’interface IUnknown. IMFAttributes compte également les types de membres suivants :
Méthodes
L’interface IMFAttributes a ces méthodes.
| IMFAttributes::Compare Compare les attributs de cet objet avec les attributs d’un autre objet. |
| IMFAttributes::CompareItem Interroge si une valeur d’attribut stockée est égale à un PROPVARIANT spécifié. |
| IMFAttributes::CopyAllItems Copie tous les attributs de cet objet dans un autre magasin d’attributs. |
| IMFAttributes::D eleteAllItems Supprime toutes les paires clé/valeur de la liste d’attributs de l’objet. |
| IMFAttributes::D eleteItem Supprime une paire clé/valeur de la liste d’attributs de l’objet. |
| IMFAttributes::GetAllocatedBlob Récupère un tableau d’octets associé à une clé. Cette méthode alloue la mémoire pour le tableau. |
| IMFAttributes::GetAllocatedString Obtient une chaîne de caractères larges associée à une clé. Cette méthode alloue la mémoire pour la chaîne. |
| IMFAttributes::GetBlob Récupère un tableau d’octets associé à une clé. Cette méthode copie le tableau dans une mémoire tampon allouée par l’appelant. |
| IMFAttributes::GetBlobSize Récupère la longueur d’un tableau d’octets associé à une clé. |
| IMFAttributes::GetCount Récupère le nombre d’attributs définis sur cet objet. |
| IMFAttributes::GetDouble Récupère une double valeur associée à une clé. |
| IMFAttributes::GetGUID Récupère une valeur GUID associée à une clé. |
| IMFAttributes::GetItem Récupère la valeur associée à une clé. |
| IMFAttributes::GetItemByIndex Récupère un attribut à l’index spécifié. |
| IMFAttributes::GetItemType Récupère le type de données de la valeur associée à une clé. |
| IMFAttributes::GetString Récupère une chaîne à caractères larges associée à une clé. |
| IMFAttributes::GetStringLength Récupère la longueur d’une valeur de chaîne associée à une clé. |
| IMFAttributes::GetUINT32 Récupère une valeur UINT32 associée à une clé. |
| IMFAttributes::GetUINT64 Récupère une valeur UINT64 associée à une clé. |
| IMFAttributes::GetUnknown Récupère un pointeur d’interface associé à une clé. |
| IMFAttributes::LockStore Verrouille le magasin d’attributs afin qu’aucun autre thread ne puisse y accéder. |
| IMFAttributes::SetBlob Associe un tableau d’octets à une clé. |
| IMFAttributes::SetDouble Associe une double valeur à une clé. |
| IMFAttributes::SetGUID Associe une valeur GUID à une clé. |
| IMFAttributes::SetItem Ajoute une valeur d’attribut avec une clé spécifiée. |
| IMFAttributes::SetString Associe une chaîne de caractères larges à une clé. |
| IMFAttributes::SetUINT32 Associe une valeur UINT32 à une clé. |
| IMFAttributes::SetUINT64 Associe une valeur UINT64 à une clé. |
| IMFAttributes::SetUnknown Associe un pointeur IUnknown à une clé. |
| IMFAttributes::UnlockStore Déverrouille le magasin d’attributs après un appel à la méthode IMFAttributes::LockStore. Lorsque l’objet est déverrouillé, plusieurs threads peuvent accéder aux attributs de l’objet. |
Notes
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 Media Center Edition) installés.
Spécifications
| 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) |