pcRegisterSubdevice 函式 (portcls.h)

PcRegisterSubdevice 函式會註冊子裝置，使其可供用戶端使用。

語法

PORTCLASSAPI NTSTATUS PcRegisterSubdevice(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] PWSTR          Name,
  [in] PUNKNOWN       Unknown
);

[in] DeviceObject

配接器驅動程式裝置物件的指標。這是類型為 DEVICE_OBJECT的系統結構。

[in] Name

指定子裝置名稱之 Null 終止 Unicode 字串的指標。 Name 參數指向的字串緩衝區，在裝置物件的存留期內必須保持有效。字串包含簡短名稱，可區別子裝置與相同裝置上註冊的任何其他子裝置。每個裝置的子裝置都必須有唯一的名稱。

[in] Unknown

系結至子裝置之埠驅動程序物件的 IPort 介面指標。

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

函式會為代表音訊配接器上子裝置的篩選對象註冊裝置介面實例。 I/O 管理員會將 Name 參數指定的字串附加至用來識別實例的參考字串。修改過的參考字串對於區分音訊配接器中的子類別很有用。如需參考字串的詳細資訊，請參閱 IoRegisterDeviceInterface。

如需註冊子裝置中 PcRegisterSubdevice 函式角色的詳細資訊，請參閱子裝置建立。

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

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