IMFMediaTypeHandler::IsMediaTypeSupported 方法 (mfidl.h)

查询对象是否支持指定的媒体类型。

语法

HRESULT IsMediaTypeSupported(
  [in]  IMFMediaType *pMediaType,
  [out] IMFMediaType **ppMediaType
);

参数

[in] pMediaType

指向要检查的媒体类型的 IMFMediaType 接口的指针。

[out] ppMediaType

接收指向最接近匹配媒体类型的 IMFMediaType 接口的指针,或接收值 NULL。 如果不是 NULL,则调用方必须释放接口。 此参数可以为 NULL。 请参阅“备注”。

返回值

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

返回代码 说明
S_OK
方法成功。
MF_E_INVALIDMEDIATYPE
对象不支持此媒体类型。

注解

如果 对象支持 pMediaType 中给定的媒体类型,则 方法将返回 S_OK。 对于媒体源,这意味着源可以生成符合该媒体类型的数据。 对于媒体接收器,这意味着接收器可以接收符合该媒体类型的数据。 如果 对象不支持媒体类型,则 方法将失败。

ppMediaType 参数是可选的。 如果 方法失败,对象可能会使用 ppMediaType 返回对象确实支持的媒体类型,该类型与 pMediaType 中给定的媒体类型非常匹配。 方法不保证在 ppMediaType 中返回媒体类型。 如果未返回任何类型,此参数将接收 NULL 指针。 如果方法成功,此参数将接收 NULL 指针。 如果调用方将 ppMediaType 设置为 NULL,则忽略此参数。

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

  • 具有 Service Pack 2 的 Windows XP (SP2) 及更高版本。
  • Windows XP Media Center Edition 2005 KB900325 (Windows XP Media Center Edition 2005) 和安装KB925766 (2006 年 10 月更新汇总的 Windows XP Media Center Edition) 。
如果安装了 Windows Media Format 11 SDK 可再发行组件,则此接口在以下平台上可用:
  • 具有 SP2 及更高版本的 Windows XP。
  • 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