MFCreateSourceReaderFromMediaSource 函数 (mfreadwrite.h)

从媒体源创建源读取器。

Syntax

HRESULT MFCreateSourceReaderFromMediaSource(
  [in]  IMFMediaSource  *pMediaSource,
  [in]  IMFAttributes   *pAttributes,
  [out] IMFSourceReader **ppSourceReader
);

参数

[in] pMediaSource

指向媒体源 的 IMFMediaSource 接口的指针。

[in] pAttributes

指向 IMFAttributes 接口的 指针。 可以使用此参数配置源读取器。 有关详细信息,请参阅 源读取器属性。 此参数可以 NULL

[out] ppSourceReader

接收指向 IMFSourceReader 接口的指针。 调用方必须释放接口。

返回值

该方法返回 HRESULT。 可能的值包括但不限于下表中的值。

返回代码 Description
S_OK
方法成功。
MF_E_DRM_UNSUPPORTED
源包含受保护的内容。

注解

在调用此函数之前调用 CoInitialize(Ex)MFStartup

默认情况下,当应用程序发布源读取器时,源读取器通过在媒体源上调用 IMFMediaSource::Shutdown 关闭媒体源来关闭媒体源。 此时,应用程序不能再使用媒体源。

若要更改此默认行为,请设置 pAttributes 参数中的MF_SOURCE_READER_DISCONNECT_MEDIASOURCE_ON_SHUTDOWN属性。 如果此属性为 TRUE,则应用程序负责关闭媒体源。

使用源读取器时,请勿在媒体源上调用以下任何方法:

如果安装了适用于 Windows Vista 的平台更新补充,则 Windows Vista 上提供此函数。

要求

Requirement 价值
最低支持的客户端 适用于 Windows Vista 的 Windows 7、Windows Vista 和平台更新补充 [桌面应用 |UWP 应用]
支持的最低服务器 Windows Server 2008 R2 [桌面应用 |UWP 应用]
目标平台 Windows操作系统
Header mfreadwrite.h
Library Mfreadwrite.lib
DLL Mfreadwrite.dll

另请参阅

Media Foundation Functions

源读取器