IMFMediaTypeHandler::GetMediaTypeByIndex 方法 (mfidl.h)

从对象的受支持媒体类型列表中检索媒体类型。

语法

HRESULT GetMediaTypeByIndex(
  [in]  DWORD        dwIndex,
  [out] IMFMediaType **ppType
);

parameters

[in] dwIndex

要检索的媒体类型的从零开始的索引。 若要获取列表中的媒体类型数,请调用 IMFMediaTypeHandler::GetMediaTypeCount

[out] ppType

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

返回值

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

返回代码 说明
S_OK
方法成功。
MF_E_NO_MORE_TYPES
dwIndex 参数范围外。

注解

媒体类型按首选项的大致顺序返回。 不支持的类型列表不保证完整。 若要测试是否支持特定媒体类型,请调用 IMFMediaTypeHandler::IsMediaTypeSupported

如果安装了 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