pcRegisterPhysicalConnectionFromExternal 函式 (portcls.h)

發行項
02/29/2024

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

指定釘選標識碼。此參數會識別 FromString所命名之外部篩選上的來源 (輸出) 釘選。

[in] ToUnknown

埠驅動程序物件的 IPort 介面指標。與 ToUnknown 相關聯的埠驅動程式物件會繫結至提供連線數據接收 (輸入) 針腳的子裝置。

[in] ToPin

指定釘選標識碼。此參數會識別與 ToUnknown 介面相關聯之篩選上的接收 (輸入) 釘選。

傳回值

如果呼叫成功，PcRegisterPhysicalConnectionFromExternal 會傳回STATUS_SUCCESS。否則，它會傳回適當的錯誤碼。

備註

配接器驅動程式會呼叫 PcRegisterPhysicalConnectionFromExternal ，向 PortCls 系統驅動程式註冊實體連線。 PortCls 會儲存這項資訊，讓埠驅動程式後續可以使用資訊來回應 KSPROPERTY_PIN_PHYSICALCONNECTION 屬性要求。

此函式適用於指定由不同配接器驅動程式控制之兩張音訊配接器之間的拓撲連結。函式會在代表本機音訊配接器中子裝置的篩選物件與代表外部配接器中子裝置的篩選對象之間註冊實體連接。

FromString 參數是外部配接器驅動程式所公開之子裝置的符號連結。

註冊外部實體連線所需的信息必須提供給這兩個驅動程式。這可以在兩部裝置的初始協調安裝期間完成，也可以由協調這兩個裝置設定變更的使用者模式設定程式動態完成。

配接器驅動程式可以呼叫 IUnregisterPhysicalConnection：：UnregisterPhysicalConnectionFromExternal 方法來刪除先前呼叫 PcRegisterPhysicalConnectionFromExternal 所註冊的實體連線註冊。如需詳細資訊，請參閱動態音訊子裝置。

規格需求

需求	值
最低支援的用戶端	PortCls 系統驅動程式會在 Microsoft Windows 98/Me 和 Windows 2000 和更新版本的操作系統中實作 PcRegisterPhysicalConnectionFromExternal 函式。
目標平台	Universal
標頭	portcls.h (包含 Portcls.h)
程式庫	Portcls.lib
IRQL	PASSIVE_LEVEL