IMFSourceReader::GetNativeMediaType 方法 (mfreadwrite.h)

获取媒体源本机支持的格式。

语法

HRESULT GetNativeMediaType(
  [in]  DWORD        dwStreamIndex,
  [in]  DWORD        dwMediaTypeIndex,
  [out] IMFMediaType **ppMediaType
);

参数

[in] dwStreamIndex

指定要查询的流。 该值可以是以下任一值。

含义
0–0xFFFFFFFB
流的从零开始的索引。
MF_SOURCE_READER_FIRST_VIDEO_STREAM
0xFFFFFFFC
第一个视频流。
MF_SOURCE_READER_FIRST_AUDIO_STREAM
0xFFFFFFFD
第一个音频流。

[in] dwMediaTypeIndex

指定要查询的媒体类型。 该值可以是以下任一值。

含义
0–0xFFFFFFFE
媒体类型的从零开始的索引
MF_SOURCE_READER_CURRENT_TYPE_INDEX
0xFFFFFFFF
当前本机媒体类型。

[out] ppMediaType

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

返回值

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

返回代码 说明
S_OK
方法成功。
MF_E_INVALIDSTREAMNUMBER
dwStreamIndex 参数无效。
MF_E_NO_MORE_TYPES
dwMediaTypeIndex 参数在范围外。

注解

此方法查询基础媒体源的本机输出格式。 每个源流可能会生成多个输出格式。 使用 dwMediaTypeIndex 参数循环访问可用的格式。 通常,文件源每个流只提供一种格式,但捕获设备可能提供多种格式。

方法返回媒体类型的副本,因此可以安全地修改 ppMediaType 参数中接收的对象。

若要设置流的输出类型,请调用 IMFSourceReader::SetCurrentMediaType 方法。

如果安装了适用于 Windows Vista 的平台更新补充,则此接口在 Windows Vista 上可用。

要求

要求
最低受支持的客户端 适用于 Windows Vista 的 Windows 7、Windows Vista 和平台更新补充 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 R2 [桌面应用 |UWP 应用]
目标平台 Windows
标头 mfreadwrite.h

另请参阅

IMFSourceReader

源读取器