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
标头 mfapi.h
Library Mfplat.lib
DLL Mfplat.dll

另请参阅

MFRegisterLocalByteStreamHandler

媒体基础函数

方案处理程序和 Byte-Stream 处理程序