CTransInPlaceFilter.CompleteConnect 方法
[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
方法 CompleteConnect 完成引脚连接。
语法
HRESULT CompleteConnect(
PIN_DIRECTION direction,
IPin *pReceivePin
);
参数
-
direction
-
PIN_DIRECTION枚举类型的成员，指定筛选器上的哪个引脚正在建立连接。
-
pReceivePin
-
指向此连接尝试中另一个引脚的 IPin 接口的指针。
返回值
返回 HRESULT。 可能的值包括下表中显示的值。
| 返回代码 | 说明 |
|---|---|
|
成功。 |
|
筛选器不在筛选器图中。 |
备注
此方法替代 CTransformFilter：：CompleteConnect 方法。
筛选器的行为取决于引脚连接的顺序：
- 如果首先连接输入引脚，则连接将使用临时分配器。 连接输出引脚后，筛选器将重新连接输入引脚。 重新连接输入引脚会导致上游筛选器重新协商分配器。 此时，输入引脚从下游筛选器建议分配器。 有关详细信息，请参阅 CTransInPlaceInputPin：：GetAllocator。
- 如果首先连接输出引脚，则输出引脚不会选择分配器。 连接输入引脚后，它将协商两个连接的分配器。 如果输入和输出媒体类型不同，筛选器将使用输入类型重新连接输出引脚。
筛选器通过调用 CBaseFilter：：ReconnectPin 方法执行所有引脚重新连接。 而 ReconnectPin 方法又调用筛选器关系图管理器上的 IFilterGraph2：：ReconnectEx 方法。
要求
| 要求 | 值 |
|---|---|
| 标头 |
|
| 库 |
|