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 |