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

  • Artigo

Recupera uma matriz de bytes associada a uma chave. Esse método aloca a memória para a matriz.

Sintaxe

HRESULT GetAllocatedBlob(
  [in]  REFGUID guidKey,
  [out] UINT8   **ppBuf,
  [out] UINT32  *pcbSize
);

Parâmetros

[in] guidKey

GUID que identifica qual valor recuperar. O tipo de atributo deve ser MF_ATTRIBUTE_BLOB.

[out] ppBuf

Se a chave for encontrada e o valor for uma matriz de bytes, esse parâmetro receberá uma cópia da matriz. O chamador deve liberar a memória da matriz chamando CoTaskMemFree.

[out] pcbSize

Recebe o tamanho da matriz, em bytes.

Retornar valor

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

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.
MF_E_ATTRIBUTENOTFOUND
 A chave especificada não foi encontrada.
MF_E_INVALIDTYPE
 O valor do atributo não é uma matriz de bytes.

Comentários

Para copiar um valor de matriz de bytes em um buffer alocado pelo chamador, use o método IMFAttributes::GetBlob .

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

Requisito Valor
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)
Biblioteca Mfuuid.lib

Confira também

Atributos e propriedades

IMFAttributes

MF_ATTRIBUTE_TYPE