Interface IMFAttributes (mfobjects.h)

Fornece uma maneira genérica de armazenar pares chave/valor em um objeto . As chaves são GUIDs e os valores podem ser qualquer um dos seguintes tipos de dados: UINT32, UINT64, double, GUID, cadeia de caracteres largos, matriz de bytes ou ponteiro IUnknown . A implementação padrão dessa interface mantém um bloqueio de thread enquanto os valores são adicionados, excluídos ou recuperados.

Para obter uma lista de GUIDsde atributos predefinidos, consulte Atributos do Media Foundation. Cada GUID de atributo tem um tipo de dados esperado. Os vários métodos "set" em IMFAttributes não validam o tipo no GUID do atributo. É responsabilidade do aplicativo definir o tipo correto para o atributo .

Para criar um repositório de atributos vazio, chame MFCreateAttributes.

Herança

A interface IMFAttributes herda da interface IUnknown . IMFAttributes também tem estes tipos de membros:

Métodos

A interface IMFAttributes tem esses métodos.

IMFAttributes::Compare Compara os atributos nesse objeto com os atributos em outro objeto.
IMFAttributes::CompareItem Consulta se um valor de atributo armazenado é igual a um PROPVARIANT especificado.
IMFAttributes::CopyAllItems Copia todos os atributos desse objeto para outro repositório de atributos.
IMFAttributes::D eleteAllItems Remove todos os pares chave/valor da lista de atributos do objeto.
IMFAttributes::D eleteItem Remove um par chave/valor da lista de atributos do objeto.
IMFAttributes::GetAllocatedBlob Recupera uma matriz de bytes associada a uma chave. Esse método aloca a memória para a matriz.
IMFAttributes::GetAllocatedString Obtém uma cadeia de caracteres largos associada a uma chave. Esse método aloca a memória para a cadeia de caracteres.
IMFAttributes::GetBlob Recupera uma matriz de bytes associada a uma chave. Esse método copia a matriz em um buffer alocado pelo chamador.
IMFAttributes::GetBlobSize Recupera o comprimento de uma matriz de bytes associada a uma chave.
IMFAttributes::GetCount Recupera o número de atributos definidos neste objeto.
IMFAttributes::GetDouble Recupera um valor duplo associado a uma chave.
IMFAttributes::GetGUID Recupera um valor GUID associado a uma chave.
IMFAttributes::GetItem Recupera o valor associado a uma chave.
IMFAttributes::GetItemByIndex Recupera um atributo no índice especificado.
IMFAttributes::GetItemType Recupera o tipo de dados do valor associado a uma chave.
IMFAttributes::GetString Recupera uma cadeia de caracteres largos associada a uma chave.
IMFAttributes::GetStringLength Recupera o comprimento de um valor de cadeia de caracteres associado a uma chave.
IMFAttributes::GetUINT32 Recupera um valor UINT32 associado a uma chave.
IMFAttributes::GetUINT64 Recupera um valor UINT64 associado a uma chave.
IMFAttributes::GetUnknown Recupera um ponteiro de interface associado a uma chave.
IMFAttributes::LockStore Bloqueia o repositório de atributos para que nenhum outro thread possa acessá-lo.
IMFAttributes::SetBlob Associa uma matriz de bytes a uma chave.
IMFAttributes::SetDouble Associa um valor duplo a uma chave.
IMFAttributes::SetGUID Associa um valor GUID a uma chave.
IMFAttributes::SetItem Adiciona um valor de atributo com uma chave especificada.
IMFAttributes::SetString Associa uma cadeia de caracteres largos a uma chave.
IMFAttributes::SetUINT32 Associa um valor UINT32 a uma chave.
IMFAttributes::SetUINT64 Associa um valor UINT64 a uma chave.
IMFAttributes::SetUnknown Associa um ponteiro IUnknown a uma chave.
IMFAttributes::UnlockStore Desbloqueia o repositório de atributos após uma chamada para o método IMFAttributes::LockStore. Enquanto o objeto é desbloqueado, vários threads podem acessar os atributos do objeto.

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.

Requisitos

Cliente mínimo com suporte	Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	mfobjects.h (inclua Mfidl.h)

Confira também

Atributos e propriedades

Media Foundation Interfaces