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