Метод IMFSourceResolver::CreateObjectFromByteStream (mfidl.h)

Статья
08/24/2023

Создает источник мультимедиа из потока байтов. Этот метод является синхронным.

Синтаксис

HRESULT CreateObjectFromByteStream(
  [in]  IMFByteStream  *pByteStream,
  [in]  LPCWSTR        pwszURL,
  [in]  DWORD          dwFlags,
  [in]  IPropertyStore *pProps,
  [out] MF_OBJECT_TYPE *pObjectType,
  [out] IUnknown       **ppObject
);

Параметры

[in] pByteStream

Указатель на интерфейс IMFByteStream потока байтов.

[in] pwszURL

Строка, завершающаяся значением NULL, содержащая URL-адрес потока байтов. URL-адрес является необязательным и может иметь значение NULL. Дополнительные сведения см. в разделе "Примечания".

[in] dwFlags

Побитовое ИЛИ флагов. См. раздел Флаги сопоставителя источника.

[in] pProps

Указатель на интерфейс IPropertyStore хранилища свойств. Метод передает хранилище свойств обработчику потока байтов. Обработчик потока байтов может использовать хранилище свойств для настройки источника мультимедиа. Этот параметр может принимать значение NULL. Дополнительные сведения см. в разделе Настройка источника мультимедиа.

[out] pObjectType

Получает элемент перечисления MF_OBJECT_TYPE , указывающий тип созданного объекта.

[out] ppObject

Получает указатель на интерфейс IUnknown источника мультимедиа. Вызывающий объект должен освободить интерфейс .

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

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

Код возврата	Описание
S_OK	Метод выполнен успешно.
MF_E_SOURCERESOLVER_MUTUALLY_EXCLUSIVE_FLAGS	Параметр dwFlags содержит взаимоисключающие флаги.
MF_E_UNSUPPORTED_BYTESTREAM_TYPE	Этот поток байтов не поддерживается.

Сопоставитель источника пытается найти один или несколько обработчиков байтового потока для потока байтов на основе расширения имени файла URL-адреса или типа MIME потока байтов (или и того, и другого). URL-адрес указывается в необязательном параметре pwszURL , а тип MIME может быть указан в атрибуте MF_BYTESTREAM_CONTENT_TYPE в потоке байтов. Обработчики потока байтов регистрируются по расширению имени файла или по типу MIME, как описано в разделе Обработчики схем и обработчики Byte-Stream. Вызывающий объект должен указать по крайней мере одно из этих значений (по возможности оба):

Укажите URL-адрес в параметре pwszURL .
Укажите тип MIME, задав атрибут MF_BYTESTREAM_CONTENT_TYPE в потоке байтов. (Этот атрибут может быть задан уже при создании потока байтов в зависимости от способа создания потока байтов.)

Примечание Этот метод не может вызываться удаленно.

Требования


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

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

IMFSourceResolver

Сопоставитель источника