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 处理程序。

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

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

szFileExtension 或 szMimeType 可以为 NULL;至少一个必须为非 NULL。