USBD_BuildRegisterCompositeDevice函数 (usbdlib.h)

USBD_BUILDREGISTERCOMPOSITEDEVICE 例程由 USB 多功能设备(复合驱动程序)的驱动程序调用,以使用向 USB 驱动程序堆栈注册驱动程序所需的信息初始化 REGISTER_COMPOSITE_DEVICE 结构。

例程由替换Microsoft提供的复合驱动程序 Usbccgp.sys的驱动程序调用。

语法

VOID USBD_BuildRegisterCompositeDevice(
  [in]  USBD_HANDLE                   USBDHandle,
  [in]  COMPOSITE_DEVICE_CAPABILITIES CapabilityFlags,
  [in]  ULONG                         FunctionCount,
  [out] PREGISTER_COMPOSITE_DEVICE    RegisterCompositeDevice
);

参数

[in] USBDHandle

在对 USBD_CreateHandle 例程的上一次调用中检索的 USBD 句柄。

[in] CapabilityFlags

调用方分配的 COMPOSITE_DEVICE_CAPABILITIES 结构,该结构指示复合驱动程序支持的功能。 例如,若要指示复合驱动程序支持函数挂起,请将 CapabilityFunctionSuspend 成员 COMPOSITE_DEVICE_CAPABILITIES 设置为 1。

[in] FunctionCount

父驱动程序要创建的物理设备对象(PDO)的数量。 FunctionCount 值不能超过 255。

[out] RegisterCompositeDevice

指向调用方分配 REGISTER_COMPOSITE_DEVICE 结构的指针。 完成后,将使用指定的注册信息填充结构。 若要注册复合驱动程序,请发送 IOCTL_INTERNAL_USB_REGISTER_COMPOSITE_DEVICE I/O 请求并传递填充的结构。

返回值

没有

要求

要求 价值
最低支持的客户端 需要适用于 Windows 8 的 WDK。 面向 Windows Vista 和更高版本的 Windows作系统。
目标平台 桌面
标头 usbdlib.h
Usbdex.lib
IRQL < = DISPATCH_LEVEL

另请参阅

IOCTL_INTERNAL_USB_REGISTER_COMPOSITE_DEVICE

REGISTER_COMPOSITE_DEVICE