структура REGISTER_COMPOSITE_DEVICE (usbdlib.h)

Статья
08/07/2023

Структура REGISTER_COMPOSITE_DEVICE используется с запросом управления IOCTL_INTERNAL_USB_REGISTER_COMPOSITE_DEVICE ввода-вывода для регистрации родительского драйвера многофункционального устройства универсальной последовательной шины (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

Возможности, поддерживаемые составным драйвером. Чтобы указать, что функция suspend поддерживается составным драйвером, сначала инициализируйте структуру COMPOSITE_DEVICE_CAPABILITIES , вызвав макрос COMPOSITE_DEVICE_CAPABILITIES_INIT . Затем задайте для элемента CompositeDeviceCapabilityFunctionSuspendCOMPOSITE_DEVICE_CAPABILITIES значение 1. Наконец, вызовите USBD_BuildRegisterCompositeDevice и передайте инициализированную структуру в параметре CapabilityFlags .

FunctionCount

Количество функций, поддерживаемых составным устройством. Значение FunctionCount не должно превышать 255.