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

  • Article

Ajoute une valeur d’attribut avec une clé spécifiée.

Syntaxe

HRESULT SetItem(
  [in] REFGUID        guidKey,
  [in] REFPROPVARIANT Value
);

Paramètres

[in] guidKey

GUID qui identifie la valeur à définir. Si cette clé existe déjà, la méthode remplace l’ancienne valeur.

[in] Value

PROPVARIANT qui contient la valeur d’attribut. La méthode copie la valeur. Le type PROPVARIANT doit être l’un des types répertoriés dans l’énumération MF_ATTRIBUTE_TYPE .

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_OUTOFMEMORY
 Mémoire insuffisante.
MF_E_INVALIDTYPE
 Type d’attribut non valide.

Remarques

Cette méthode vérifie si le type PROPVARIANT est l’un des types d’attributs définis dans MF_ATTRIBUTE_TYPE et échoue si un type non pris en charge est utilisé. Toutefois, cette méthode n’case activée pas si propVARIANT est le type correct pour le GUID d’attribut spécifié. (Il n’existe aucun moyen programmatique d’associer des GUID d’attributs à des types de propriétés.) Pour obtenir la liste des attributs Media Foundation et leurs types de données, consultez Attributs Media Foundation.

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.

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

Attributs et propriétés

IMFAttributes