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

Recupera o valor associado a uma chave.

Sintaxe

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

Parâmetros

[in] guidKey

Um GUID que identifica qual valor recuperar.

[in, out] pValue

Um ponteiro para um PROPVARIANT que recebe o valor. O método preenche o PROPVARIANT com uma cópia do valor armazenado, se o valor for encontrado. Chame PropVariantClear para liberar a memória alocada por esse método. Este parâmetro pode ser NULL. Se esse parâmetro for NULL, o método procurará a chave e retornará S_OK se a chave for encontrada, mas não copiará o valor.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Comentários

Essa interface estará disponível nas seguintes plataformas se os componentes redistribuíveis do SDK do Windows Media Format 11 estiverem instalados:

• Windows XP com Service Pack 2 (SP2) e posterior.
• Windows XP Media Center Edition 2005 com KB900325 (Windows XP Media Center Edition 2005) e KB925766 (pacote cumulativo de atualizações de outubro de 2006 para Windows XP Media Center Edition) instalados.

Exemplos

O exemplo a seguir copia um atributo de um repositório de atributos para outro.

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

Confira também

Atributos e propriedades

IMFAttributes