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 |