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 值之一。
| 返回代码 | 说明 |
|---|---|
|
成功。 |
|
索引范围外。 |
|
索引小于零。 |
|
意外错误。 |
备注
此方法有两个版本。 一个版本替代 CBasePin：：GetMediaType 方法，并将索引值作为参数。 另一个版本旨在检索单个媒体类型，因此缺少索引参数。
单参数方法返回E_UNEXPECTED。 双参数方法验证 iPosition 参数是否为零，然后调用单参数版本。 根据引脚支持的媒体类型数量，必须重写以下方法之一：
- 如果引脚仅支持一种媒体类型，请重写单参数版本。 填写图钉支持的媒体类型。
- 如果引脚支持多个媒体类型，请重写双参数版本。 另请重写 CSourceStream：：CheckMediaType 方法。
要求
| 要求 | 值 |
|---|---|
| 标头 |
|
| 库 |
|