Compartilhar via


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