pcRegisterPhysicalConnectionFromExternal 函数 (portcls.h)

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 属性请求。

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

FromString 参数是外部适配器驱动程序公开的子参数的符号链接。

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

适配器驱动程序可以调用 IUnregisterPhysicalConnection::UnregisterPhysicalConnectionFromExternal 方法来删除以前调用 PcRegisterPhysicalConnectionFromExternal 注册的物理连接的注册。 有关详细信息,请参阅 动态音频子级

要求

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

另请参阅

DEVICE_OBJECT

IPort

IUnregisterPhysicalConnection::UnregisterPhysicalConnectionFromExternal

KSPROPERTY_PIN_PHYSICALCONNECTION

PcRegisterPhysicalConnection

PcRegisterPhysicalConnectionToExternal