REGISTER_COMPOSITE_DEVICE 结构 (usbdlib.h)

项目
02/26/2024

REGISTER_COMPOSITE_DEVICE 结构与 IOCTL_INTERNAL_USB_REGISTER_COMPOSITE_DEVICE I/O 控制请求一起使用，以便将通用串行总线 (USB) 多功能设备的父驱动程序 (复合驱动程序) 注册到 USB 驱动程序堆栈。

若要初始化 REGISTER_COMPOSITE_DEVICE 结构，复合驱动程序必须调用 USBD_BuildRegisterCompositeDevice 例程。

语法

typedef struct _REGISTER_COMPOSITE_DEVICE {
  USHORT                        Version;
  USHORT                        Size;
  USBDI_HANDLE                  Reserved;
  COMPOSITE_DEVICE_CAPABILITIES CapabilityFlags;
  ULONG                         FunctionCount;
} REGISTER_COMPOSITE_DEVICE, *PREGISTER_COMPOSITE_DEVICE;

成员

Version

此结构的版本。 USBD_BuildRegisterCompositeDevice 设置此成员。

Size

此结构的大小。 USBD_BuildRegisterCompositeDevice 设置此成员。

Reserved

保留。 USBD_BuildRegisterCompositeDevice 设置此成员。

CapabilityFlags

复合驱动程序支持的功能。若要指定复合驱动程序支持函数挂起，请先通过调用 COMPOSITE_DEVICE_CAPABILITIES_INIT 宏来初始化 COMPOSITE_DEVICE_CAPABILITIES 结构。然后，将 COMPOSITE_DEVICE_CAPABILITIES 的 CompositeDeviceCapabilityFunctionSuspend 成员设置为 1。最后，调用 USBD_BuildRegisterCompositeDevice 并在 CapabilityFlags 参数中传递初始化的结构。

FunctionCount

复合设备支持的函数数。 FunctionCount 值不能超过 255。