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

  • Статья

Начинает асинхронный запрос на создание источника мультимедиа или потока байтов из URL-адреса.

Синтаксис

HRESULT BeginCreateObjectFromURL(
  [in]  LPCWSTR          pwszURL,
  [in]  DWORD            dwFlags,
  [in]  IPropertyStore   *pProps,
  [out] IUnknown         **ppIUnknownCancelCookie,
  [in]  IMFAsyncCallback *pCallback,
  [in]  IUnknown         *punkState
);

Параметры

[in] pwszURL

Строка, завершающаяся значением NULL, содержащая URL-адрес для разрешения.

[in] dwFlags

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

[in] pProps

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

[out] ppIUnknownCancelCookie

Получает указатель IUnknown или значение NULL. Если значение не равно NULL, можно отменить асинхронную операцию, передав этот указатель на метод IMFSourceResolver::CancelObjectCreation . Вызывающий объект должен освободить интерфейс . Этот параметр может принимать значение NULL.

[in] pCallback

Указатель на интерфейс IMFAsyncCallback объекта обратного вызова. Вызывающий объект должен реализовать этот интерфейс.

[in] punkState

Указатель на интерфейс IUnknown объекта состояния, определенного вызывающим объектом. Этот параметр может принимать значение NULL. Этот объект можно использовать для хранения сведений о состоянии. Объект возвращается вызывающей объекту при вызове обратного вызова.

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

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

Код возврата Описание
S_OK
 Метод выполнен успешно.
MF_E_SOURCERESOLVER_MUTUALLY_EXCLUSIVE_FLAGS
 Параметр dwFlags содержит взаимоисключающие флаги.
MF_E_UNSUPPORTED_SCHEME
 Схема URL-адресов не поддерживается.

Комментарии

Параметр dwFlags должен содержать флаг MF_RESOLUTION_MEDIASOURCE или флаг MF_RESOLUTION_BYTESTREAM, но не должен содержать оба флага.

Для локальных файлов можно передать имя файла в параметре pwszURL ; file: схема не является обязательной.

После завершения операции сопоставитель источника вызывает метод IMFAsyncCallback::Invoke . Метод Invoke должен вызвать IMFSourceResolver::EndCreateObjectFromURL , чтобы получить указатель на созданный объект.

Использование параметра pProps зависит от реализации источника мультимедиа.

Требования

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

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

IMFSourceResolver

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