IMFMediaTypeHandler::SetCurrentMediaType 方法 (mfidl.h)

设置对象的媒体类型。

语法

HRESULT SetCurrentMediaType(
  [in] IMFMediaType *pMediaType
);

parameters

[in] pMediaType

指向新 媒体类型的 IMFMediaType 接口的指针。

返回值

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

返回代码 说明
S_OK
方法成功。
MF_E_INVALIDREQUEST
请求无效。

注解

对于媒体源,设置媒体类型意味着源将生成符合该媒体类型的数据。 对于媒体接收器,设置媒体类型意味着接收器可以接收符合该媒体类型的数据。

此方法的任何实现都应检查 pMediaType 是否与对象的当前媒体类型不同。 如果类型相同,该方法应返回S_OK但避免不必要地释放和重新创建资源。 如果类型不相同,该方法应验证新类型。

如果安装了 Windows Media Format 11 SDK 可再发行组件,则此接口在以下平台上可用:

  • Windows XP with Service Pack 2 (SP2) 及更高版本。
  • Windows XP Media Center Edition 2005 KB900325 (windows XP Media Center Edition 2005) 和KB925766 (2006 年 10 月 Windows XP Media Center Edition 更新汇总) 安装。

要求

   
最低受支持的客户端 Windows Vista [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2008 [桌面应用 | UWP 应用]
目标平台 Windows
标头 mfidl.h
Library Mfuuid.lib

另请参阅

IMFMediaTypeHandler