MFRegisterLocalByteStreamHandler 函数 (mfapi.h)

在调用方进程中注册字节流处理程序。

语法

HRESULT MFRegisterLocalByteStreamHandler(
  [in] PCWSTR      szFileExtension,
  [in] PCWSTR      szMimeType,
  [in] IMFActivate *pActivate
);

参数

[in] szFileExtension

包含此处理程序的文件扩展名的字符串。

[in] szMimeType

包含此处理程序的 MIME 类型的字符串。

[in] pActivate

指向激活对象的 IMFActivate 接口的指针。 调用方实现此接口。 激活对象的 IMFActivate::ActivateObject 方法必须创建字节流处理程序。 字节流处理程序公开 IMFByteStreamHandler 接口。

返回值

如果此函数成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

字节流处理程序在源解析过程中在 Microsoft Media Foundation 中使用,这会从 URL 创建媒体源。 有关详细信息,请参阅 方案处理程序和 Byte-Stream 处理程序

在进程中,本地字节流处理程序优先于注册表中注册的字节流处理程序。 本地字节流处理程序对其他进程不可见。

如果要为应用程序注册自定义字节流处理程序,但不希望该处理程序可供其他应用程序使用,请使用此函数。

szFileExtensionszMimeType 可以为 NULL;至少一个必须为非 NULL

要求

要求
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
目标平台 Windows
标头 mfapi.h
Library Mfplat.lib
DLL Mfplat.dll

另请参阅

媒体基础函数

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