pcRegisterPhysicalConnectionToExternal 函数 (portcls.h)

项目
02/29/2024

PcRegisterPhysicalConnectionToExternal 函数注册从音频适配器筛选器到外部音频适配器筛选器的物理连接。

语法

PORTCLASSAPI NTSTATUS PcRegisterPhysicalConnectionToExternal(
  [in] PDEVICE_OBJECT  DeviceObject,
  [in] PUNKNOWN        FromUnknown,
  [in] ULONG           FromPin,
  [in] PUNICODE_STRING ToString,
  [in] ULONG           ToPin
);

参数

[in] DeviceObject

指向设备的设备对象的指针。这是 DEVICE_OBJECT 类型的系统结构。

[in] FromUnknown

指向端口驱动程序对象的 IPort 接口的指针。与 FromUnknown 关联的端口驱动程序对象绑定到子设备，该子设备提供连接的数据源 (输出) 引脚。

[in] FromPin

指定引脚 ID。此参数标识与 FromUnknown 接口关联的筛选器上的源 (输出) 引脚。

[in] ToString

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含为连接提供接收器引脚的外部筛选器的符号链接名称。

[in] ToPin

指定引脚 ID。此参数标识 由 ToString 命名的外部筛选器上的接收器 (输入) 引脚。

返回值

如果调用成功，PcRegisterPhysicalConnectionToExternal 将返回STATUS_SUCCESS。否则，它将返回相应的错误代码。

注解

适配器驱动程序调用 PcRegisterPhysicalConnectionToExternal 以向 PortCls 系统驱动程序注册物理连接。 PortCls 存储此信息，以便端口驱动程序随后可以使用该信息响应 KSPROPERTY_PIN_PHYSICALCONNECTION 属性请求。

此函数可用于指定由不同适配器驱动程序控制的两个音频适配器之间的拓扑链接。函数在本地音频适配器中表示子设备的筛选器对象与表示外部适配器中的子设备的筛选器对象之间注册物理连接。

ToString 参数是指向外部适配器驱动程序公开的子设备的符号链接。

注册外部物理连接所需的信息必须提供给两个驱动程序。这可以在两台设备的初始协调安装期间完成，也可以由协调两个设备配置更改的用户模式配置程序动态完成。

适配器驱动程序可以调用 IUnregisterPhysicalConnection：：UnregisterPhysicalConnectionToExternal 方法来删除以前调用 PcRegisterPhysicalConnectionToExternal 注册的物理连接的注册。有关详细信息，请参阅动态音频子设备。

要求

要求	值
最低受支持的客户端	PortCls 系统驱动程序在 Microsoft Windows 98/Me 和 Windows 2000 及更高版本的操作系统中实现 PcRegisterPhysicalConnectionToExternal 函数。
目标平台	通用
标头	portcls.h (包括 Portcls.h)
Library	Portcls.lib
IRQL	PASSIVE_LEVEL