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 函数的角色的详细信息,请参阅 Subdevice Creation

适配器驱动程序可以调用 IUnregisterSubdevice::UnregisterSubdevice 方法来删除以前调用 PcRegisterSubdevice 注册的物理连接的注册。 有关详细信息,请参阅 动态音频子级

要求

   
最低受支持的客户端 PortCls 系统驱动程序在 Microsoft Windows 98/Me 和 Windows 2000 及更高版本的操作系统中实现 PcRegisterSubdevice 函数。
目标平台 通用
标头 portcls.h (包括 Portcls.h)
Library Portcls.lib
IRQL PASSIVE_LEVEL

请参阅

DEVICE_OBJECT

IPort

IUnregisterSubdevice::UnregisterSubdevice

IoRegisterDeviceInterface