IMFMediaTypeHandler::SetCurrentMediaType 方法 (mfidl.h)
设置对象的媒体类型。
语法
HRESULT SetCurrentMediaType(
[in] IMFMediaType *pMediaType
);
parameters
[in] pMediaType
指向新 媒体类型的 IMFMediaType 接口的指针。
返回值
该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
请求无效。 |
注解
对于媒体源,设置媒体类型意味着源将生成符合该媒体类型的数据。 对于媒体接收器,设置媒体类型意味着接收器可以接收符合该媒体类型的数据。
此方法的任何实现都应检查 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 |