pcRegisterPhysicalConnectionToExternal 函式 (portcls.h)

發行項
02/26/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

指定釘選標識碼。此參數會識別與 FromUnknown 介面相關聯之篩選上的來源 (輸出) 釘選。

[in] ToString

Null 終止 Unicode 字串的指標，其中包含提供連接接收針腳之外部篩選的符號連結名稱。

[in] ToPin

指定釘選標識碼。此參數會識別由 ToString 所命名之外部篩選上的接收 (輸入) 針腳。

傳回值

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

備註

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

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

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

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

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

規格需求

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