Функция 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

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

MFRegisterLocalByteStreamHandler

Функции Media Foundation

Обработчики схем и обработчики Byte-Stream