Метод IMFAttributes::GetAllocatedBlob (mfobjects.h)

  • Статья

Извлекает массив байтов, связанный с ключом. Этот метод выделяет память для массива.

Синтаксис

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

Параметры

[in] guidKey

GUID, определяющий, какое значение следует извлечь. Тип атрибута должен быть MF_ATTRIBUTE_BLOB.

[out] ppBuf

Если ключ найден, а значение представляет собой массив байтов, этот параметр получает копию массива. Вызывающий объект должен освободить память для массива, вызвав CoTaskMemFree.

[out] pcbSize

Получает размер массива в байтах.

Возвращаемое значение

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата Описание
S_OK
 Метод выполнен успешно.
MF_E_ATTRIBUTENOTFOUND
 Указанный ключ не найден.
MF_E_INVALIDTYPE
 Значение атрибута не является массивом байтов.

Комментарии

Чтобы скопировать значение массива байтов в буфер, выделенный вызывающим объектом, используйте метод IMFAttributes::GetBlob .

Этот интерфейс доступен на следующих платформах, если установлены распространяемые компоненты пакета SDK формата 11 для Windows Media:

  • Windows XP с пакетом обновления 2 (SP2) и более поздних версий.
  • Windows XP Media Center Edition 2005 с установленным KB900325 (Windows XP Media Center Edition 2005) и KB925766 (накопительный пакет обновления для Windows XP Media Center Edition за октябрь 2006 г.).

Требования

Требование Значение
Минимальная версия клиента Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header mfobjects.h (включая Mfidl.h)
Библиотека Mfuuid.lib

См. также раздел

Атрибуты и свойства

IMFAttributes

MF_ATTRIBUTE_TYPE