Функция MFRegisterLocalSchemeHandler (mfapi.h)
Регистрирует обработчик схемы в процессе вызывающего.
Синтаксис
HRESULT MFRegisterLocalSchemeHandler(
[in] PCWSTR szScheme,
[in] IMFActivate *pActivate
);
Параметры
[in] szScheme
Строка, содержащая схему. Схема включает в себя символ в конце ":"; Например, "http:".
[in] pActivate
Указатель на интерфейс IMFActivate объекта активации. Вызывающий объект реализует этот интерфейс. Метод IMFActivate::ActivateObject объекта активации должен создать объект обработчика схемы. Обработчик схемы предоставляет интерфейс IMFSchemeHandler .
Возвращаемое значение
Если эта функция завершается успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Обработчики схем используются в Microsoft Media Foundation во время процесса разрешения источника, который создает источник мультимедиа на основе URL-адреса. Дополнительные сведения см. в разделе Обработчики схем и обработчики Byte-Stream.
В рамках процесса локальные обработчики схем имеют приоритет над обработчиками схем, зарегистрированных в реестре. Обработчики локальных схем не видны другим процессам.
Используйте эту функцию, если вы хотите зарегистрировать настраиваемый обработчик схемы для приложения, но не хотите, чтобы обработчик был доступен для других приложений.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2012 [только классические приложения] |
| Целевая платформа | Windows |
| Header | mfapi.h |
| Библиотека | Mfplat.lib |
| DLL | Mfplat.dll |