CTransformOutputPin.GetMediaType 方法

[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayerIMFMediaEngineMedia Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayerIMFMediaEngine音频/视频捕获 ,而不是 DirectShow。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

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

语法

HRESULT GetMediaType(
   int        iPosition,
   CMediaType *pMediaType
);

参数

iPosition

从零开始的索引值。

pMediaType

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

返回值

返回 HRESULT 值。 可能的值包括下表中显示的值。

返回代码 说明
S_OK
成功
VFW_S_NO_MORE_ITEMS
索引范围外

备注

此方法替代 CBasePin::GetMediaType 方法。 如果筛选器的输入引脚未连接,该方法将返回VFW_S_NO_MORE_ITEMS。 否则,它会调用筛选器的 CTransformFilter::GetMediaType 方法来检索媒体类型。 CTransformFilter::GetMediaType 方法是纯虚拟的;筛选器的派生类必须重写它。

要求

要求
标头
Transfrm.h (包括 Streams.h)

Strmbase.lib (零售版本) ;
Strmbasd.lib (调试生成)