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 函数。 |
目标平台 | 通用 |
标头 | portcls.h (包括 Portcls.h) |
Library | Portcls.lib |
IRQL | PASSIVE_LEVEL |