CDynamicOutputPin.ChangeMediaType 方法
[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
方法 ChangeMediaType 动态更改连接的媒体类型。 筛选器图运行时可能会发生更改。 调用此方法后，无法传递具有旧媒体类型的示例。 调用方必须确保没有挂起的旧示例。
语法
HRESULT ChangeMediaType(
const CMediaType *pmt
);
参数
-
Pmt
-
指向指定媒体类型的 AM_MEDIA_TYPE 结构的指针。
返回值
返回 HRESULT 值。 可能的值包括下表中显示的值。
| 返回代码 | 说明 |
|---|---|
|
成功。 |
|
失败。 可能拥有的筛选器未调用 CDynamicOutputPin：：SetConfigInfo。 |
|
引脚未连接。 |
备注
调用此方法之前，请调用 CDynamicOutputPin：：StartUsingOutputPin 方法。
此方法首先检查下游输入引脚是否可以在不重新连接的情况下接受新格式。 它查询 IPinConnection 接口的输入引脚。 如果输入引脚支持 IPinConnection，则该方法使用建议的媒体类型调用 IPinConnection：:D ynamicQueryAccept 方法。 如果输入引脚接受新媒体类型，该方法将调用 IPin：：ReceiveConnection 方法并重新确定分配器要求。
另一方面，如果下游引脚不支持 IPinConnection，或者如果它拒绝新媒体类型，该方法将调用 CDynamicOutputPin：:D ynamicReconnect 方法来执行动态重新连接。
要求
| 要求 | 值 |
|---|---|
| 标头 |
|
| 库 |
|