CBasePin.Connect 方法
[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ,而不是 DirectShow。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
方法 Connect
将引脚连接到另一个引脚。 此方法实现 IPin::Connect 方法。
语法
HRESULT Connect(
IPin *pReceivePin,
const AM_MEDIA_TYPE *pmt
);
参数
-
pReceivePin
-
指向接收引脚的 IPin 接口的指针。
-
Pmt
-
指向 AM_MEDIA_TYPE 结构的指针,该结构指定连接的媒体类型。
返回值
返回 HRESULT 值。 可能的值包括下表中的值。
返回代码 | 说明 |
---|---|
|
成功。 |
|
引脚已连接。 |
|
找不到可接受的媒体类型。 |
|
筛选器处于活动状态,并且引脚不支持动态重新连接。 |
|
指定的媒体类型是不能接受的。 |
备注
pmt 参数可以为 NULL。 它还可以指定部分媒体类型,主要类型、子类型或格式的值为 GUID_NULL。
在基类中,此方法测试引脚是否已连接以及筛选器是否已停止。 它将连接过程的其余部分委托给 CBasePin::AgreeMediaType 方法。
要求
要求 | 值 |
---|---|
标头 |
|
库 |
|