CBasePin.GetMediaType 方法

  • 项目

[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ，而不是 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
 意外错误。

备注

从引脚的首选媒体类型列表中，此方法返回索引值为 iPosition 的类型。 CEnumMediaTypes 类调用此方法以枚举首选媒体类型。

基类返回E_UNEXPECTED。 在派生类中重写此方法。

要求

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

另请参阅

CBasePin 类