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

Récupère la valeur associée à une clé.

Syntaxe

HRESULT GetItem(
  [in]      REFGUID     guidKey,
  [in, out] PROPVARIANT *pValue
);

Paramètres

[in] guidKey

GUID qui identifie la valeur à récupérer.

[in, out] pValue

Pointeur vers un PROPVARIANT qui reçoit la valeur. La méthode remplit le PROPVARIANT avec une copie de la valeur stockée, si la valeur est trouvée. Appelez PropVariantClear pour libérer la mémoire allouée par cette méthode. Ce paramètre peut être NULL. Si ce paramètre a la valeur NULL, la méthode recherche la clé et retourne S_OK si la clé est trouvée, mais ne copie pas la valeur.

Valeur retournée

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

Remarques

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.

Exemples

L’exemple suivant copie un attribut d’un magasin d’attributs vers un autre.

HRESULT CopyAttribute(IMFAttributes *pFrom, IMFAttributes *pTo, REFGUID guidKey)
{
    PROPVARIANT val;

    HRESULT hr = pFrom->GetItem(guidKey, &val);

    if (SUCCEEDED(hr))
    {
        hr = pTo->SetItem(guidKey, val);
        PropVariantClear(&val);
    }
    else if (hr == MF_E_ATTRIBUTENOTFOUND)
    {
        hr = S_OK;
    }
    return hr;
}

Configuration requise

Voir aussi

Attributs et propriétés

IMFAttributes