CSourceStream.GetMediaType 方法 (Source.h)

  • 项目

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

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

语法

virtual HRESULT GetMediaType(
   CMediaType *pMediaType
);

参数

pMediaType

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

返回值

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

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

备注

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

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

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

要求

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

另请参阅

CSourceStream 类