IMFSourceReader::GetNativeMediaType 方法 (mfreadwrite.h)
获取媒体源本机支持的格式。
语法
HRESULT GetNativeMediaType(
[in] DWORD dwStreamIndex,
[in] DWORD dwMediaTypeIndex,
[out] IMFMediaType **ppMediaType
);
参数
[in] dwStreamIndex
指定要查询的流。 该值可以是以下任一值。
值 | 含义 |
---|---|
|
流的从零开始的索引。 |
|
第一个视频流。 |
|
第一个音频流。 |
[in] dwMediaTypeIndex
指定要查询的媒体类型。 该值可以是以下任一值。
值 | 含义 |
---|---|
|
媒体类型的从零开始的索引 |
|
当前本机媒体类型。 |
[out] ppMediaType
接收指向 IMFMediaType 接口的指针。 调用方必须释放接口。
返回值
该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
dwStreamIndex 参数无效。 |
|
dwMediaTypeIndex 参数在范围外。 |
注解
此方法查询基础媒体源的本机输出格式。 每个源流可能会生成多个输出格式。 使用 dwMediaTypeIndex 参数循环访问可用的格式。 通常,文件源每个流只提供一种格式,但捕获设备可能提供多种格式。
方法返回媒体类型的副本,因此可以安全地修改 ppMediaType 参数中接收的对象。
若要设置流的输出类型,请调用 IMFSourceReader::SetCurrentMediaType 方法。
如果安装了适用于 Windows Vista 的平台更新补充,则此接口在 Windows Vista 上可用。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 适用于 Windows Vista 的 Windows 7、Windows Vista 和平台更新补充 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows Server 2008 R2 [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | mfreadwrite.h |