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

Recupera el valor asociado a una clave.

Sintaxis

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

Parámetros

[in] guidKey

GUID que identifica qué valor se va a recuperar.

[in, out] pValue

Puntero a un PROPVARIANT que recibe el valor. El método rellena el PROPVARIANT con una copia del valor almacenado, si se encuentra el valor. Llame a PropVariantClear para liberar la memoria asignada por este método. Este parámetro puede ser NULL. Si este parámetro es NULL, el método busca la clave y devuelve S_OK si se encuentra la clave, pero no copia el valor.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Comentarios

Esta interfaz está disponible en las siguientes plataformas si se instalan los componentes redistribuibles del SDK de Windows Media Format 11:

• Windows XP con Service Pack 2 (SP2) y versiones posteriores.
• Windows XP Media Center Edition 2005 con KB900325 (Windows XP Media Center Edition 2005) y KB925766 (paquete acumulativo de actualizaciones de octubre de 2006 para Windows XP Media Center Edition) instalados.

Ejemplos

En el ejemplo siguiente se copia un atributo de un almacén de atributos a otro.

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;
}

Requisitos

Consulte también

Atributos y propiedades

IMFAttributes