CSourceStream.GetMediaType 方法 (Source.h) - iPosition 和 pMediaType 参数

  • 项目

[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

GetMediaType 方法检索首选媒体类型。

语法

virtual HRESULT GetMediaType(
   int        iPosition,
   CMediaType *pMediaType
);

参数

iPosition

从零开始的索引值。

pMediaType

指向接收媒体类型的 CMediaType 对象的指针。

返回值

返回下表中显示的 HRESULT 值之一。

返回代码 说明
S_OK
 成功。
VFW_S_NO_MORE_ITEMS
 索引范围外。
E_INVALIDARG
 索引小于零。
E_UNEXPECTED
 意外错误。

备注

此方法有两个版本。 一个版本替代 CBasePin：：GetMediaType 方法，并采用索引值作为参数。 另一个版本旨在检索单个媒体类型，因此缺少 index 参数。

单参数方法返回E_UNEXPECTED。 双参数方法验证 iPosition 参数是否为零，然后调用单参数版本。 根据引脚支持的媒体类型数，必须重写以下方法之一：

  • 如果引脚仅支持一种媒体类型，请替代单参数版本。 填写引脚支持的媒体类型。
  • 如果引脚支持多个媒体类型，请替代双参数版本。 另请重写 CSourceStream：：CheckMediaType 方法。

要求

要求 值
标头 Source.h (包括 Streams.h)
库 Strmbase.lib (零售版本) ;Strmbasd.lib (调试生成)

另请参阅

CSourceStream 类