PcRegisterPhysicalConnectionFromExternal 函数从外部音频适配器筛选器注册与音频适配器筛选器的物理连接。
语法
PORTCLASSAPI NTSTATUS PcRegisterPhysicalConnectionFromExternal(
[in] PDEVICE_OBJECT DeviceObject,
[in] PUNICODE_STRING FromString,
[in] ULONG FromPin,
[in] PUNKNOWN ToUnknown,
[in] ULONG ToPin
);
参数
[in] DeviceObject
指向设备的设备对象的指针。 这是 DEVICE_OBJECT类型的系统结构。
[in] FromString
指向以 null 结尾的 Unicode 字符串的指针，该字符串包含提供连接源引脚的外部筛选器的符号链接名称。
[in] FromPin
指定引脚 ID。 此参数标识由 FromString命名的外部筛选器上的源（输出）引脚。
[in] ToUnknown
指向端口驱动程序对象的 IPort 接口的指针。 与 ToUnknown 关联的端口驱动程序对象绑定到提供连接的数据接收器（输入）引脚的子设备。
[in] ToPin
指定引脚 ID。 此参数标识与 ToUnknown 接口关联的筛选器上的接收器（输入）引脚。
返回值
PcRegisterPhysicalConnectionFromExternal 如果调用成功，则返回STATUS_SUCCESS。 否则，它将返回适当的错误代码。
言论
适配器驱动程序调用 PcRegisterPhysicalConnectionFromExternal，以注册与 PortCls 系统驱动程序的物理连接。 PortCls 存储此信息，以便端口驱动程序随后可以使用该信息来响应 KSPROPERTY_PIN_PHYSICALCONNECTION 属性请求。
此函数可用于指定由不同适配器驱动程序控制的两个音频适配器之间的拓扑链接。 该函数在一个筛选器对象之间注册物理连接，该对象表示本地音频适配器中的子Evice，以及表示外部适配器中的子对象的筛选器对象。
FromString 参数 是外部适配器驱动程序公开的子实现的符号链接。
必须向两个驱动程序提供注册外部物理连接所需的信息。 这可以在两台设备的初始协调安装过程中完成，也可以由协调两台设备配置更改的用户模式配置程序动态完成。
适配器驱动程序可以调用 IUnregisterPhysicalConnection：：UnregisterPhysicalConnectionFromExternal 方法，以删除先前调用 PcRegisterPhysicalConnectionFromExternal注册的物理连接的注册。 有关详细信息，请参阅 动态音频子。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | PortCls 系统驱动程序在 Microsoft Windows 98/Me 和 Windows 2000 及更高版本的作系统中实现 PcRegisterPhysicalConnectionFromExternal 函数。 |
| 目标平台 | 普遍 |
| 标头 | portcls.h （包括 Portcls.h） |
| 库 | Portcls.lib |
| IRQL | PASSIVE_LEVEL |
另请参阅
IUnregisterPhysicalConnection：：UnregisterPhysicalConnectionFromExternal