pcRegisterPhysicalConnection 函数 (portcls.h)
PcRegisterPhysicalConnection 函数在由同一适配器驱动程序实例化的两个音频适配器筛选器之间注册物理连接。
语法
PORTCLASSAPI NTSTATUS PcRegisterPhysicalConnection(
[in] PDEVICE_OBJECT DeviceObject,
[in] PUNKNOWN FromUnknown,
[in] ULONG FromPin,
[in] PUNKNOWN ToUnknown,
[in] ULONG ToPin
);
参数
[in] DeviceObject
指向适配器设备的设备对象的指针。 此参数必须指向 DEVICE_OBJECT类型的系统结构。
[in] FromUnknown
指向端口驱动程序对象的 IPort 接口的指针。 与 FromUnknown 关联的端口驱动程序对象绑定到提供连接数据源的子组件， (输出) 引脚。
[in] FromPin
指定固定 ID。 此参数标识与 FromUnknown 接口关联的筛选器上的源 (输出) 引脚。
[in] ToUnknown
指向端口驱动程序对象的 IPort 接口的指针。 与 ToUnknown 关联的端口驱动程序对象绑定到提供连接的数据接收器 (输入) 引脚的子节点。
[in] ToPin
指定固定 ID。 此参数标识与 ToUnknown 接口关联的筛选器上的接收器 (输入) 引脚。
返回值
如果调用成功，PcRegisterPhysicalConnection 将返回STATUS_SUCCESS。 否则，它将返回适当的错误代码。
注解
适配器驱动程序调用 PcRegisterPhysicalConnection 以向 PortCls 系统驱动程序注册物理连接。 PortCls 存储此信息，以便端口驱动程序随后可以使用该信息响应 KSPROPERTY_PIN_PHYSICALCONNECTION 属性请求。
调用方提供给 PcRegisterPhysicalConnection 函数的参数描述了两个子实体之间的物理连接， (表示为同一适配器卡上的单个筛选器) 。
与可在软件控制下配置的两个引脚之间的逻辑连接不同，物理连接是硬连接。 例如，典型的适配器卡可能有一个物理连接，该连接将模拟信号从其波形输出筛选器的输出引脚传送到其 拓扑筛选器的输入引脚。
有关适配器驱动程序设备启动例程的示例 (请参阅使用 PcRegisterPhysicalConnection 调用注册适配器物理连接的启动序列) ，请参阅 Microsoft Windows 驱动程序工具包中 SB16 示例音频驱动程序的源代码 (WDK) 。
适配器驱动程序可以调用 IUnregisterPhysicalConnection：：UnregisterPhysicalConnection 方法来删除以前调用 PcRegisterPhysicalConnection 注册的物理连接的注册。 有关详细信息，请参阅 动态音频子级。
要求
| 最低受支持的客户端 | PortCls 系统驱动程序在 Microsoft Windows 98/Me 和 Windows 2000 及更高版本的操作系统中实现 PcRegisterPhysicalConnection 函数。 |
| 目标平台 | 通用 |
| 标头 | portcls.h (包括 Portcls.h) |
| Library | Portcls.lib |
| IRQL | PASSIVE_LEVEL |
另请参阅
IUnregisterPhysicalConnection：：UnregisterPhysicalConnection
KSPROPERTY_PIN_PHYSICALCONNECTION