Метод 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. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.
| Код возврата | Описание |
|---|---|
|
Метод выполнен успешно. |
|
Параметр dwFlags содержит взаимоисключающие флаги. |
|
Схема 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 |