PcRegisterPhysicalConnection 函式 (portcls.h)

發行項
02/29/2024

PcRegisterPhysicalConnection 函式會在由相同配接器驅動程式具現化的兩個音訊配接器篩選器之間註冊實體連線。

語法

PORTCLASSAPI NTSTATUS PcRegisterPhysicalConnection(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] PUNKNOWN       FromUnknown,
  [in] ULONG          FromPin,
  [in] PUNKNOWN       ToUnknown,
  [in] ULONG          ToPin
);

參數

[in] DeviceObject

適配卡裝置之裝置物件的指標。此參數必須指向類型為 DEVICE_OBJECT的系統結構。

[in] FromUnknown

埠驅動程序物件的 IPort 介面指標。與 FromUnknown 相關聯的埠驅動程式物件會繫結至提供連線數據源的子裝置， (輸出) 釘選。

[in] FromPin

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

[in] ToUnknown

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

[in] ToPin

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

傳回值

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

備註

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

呼叫端提供給 PcRegisterPhysicalConnection 函式的參數描述兩個子裝置之間的實體連線， (以相同配接卡上的個別篩選) 表示。

不同於兩個針腳之間的邏輯連線，這可以在軟體控制下設定，實體聯機會硬式連線。例如，一般適配卡可能會有實體連線，該連接會從其波浪輸出篩選器的輸出針腳到其拓撲篩選器的輸入針腳。

如需適配卡驅動程式的裝置啟動例程範例 (請參閱使用PcRegisterPhysicalConnection呼叫來註冊適配卡實體連線的啟動順序) ，請參閱 Microsoft Windows Driver Kit (WDK) 中 SB16 範例音頻驅動程式的原始程式碼。

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

規格需求

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