функция USBD_BuildRegisterCompositeDevice (usbdlib.h)

Подпрограмма USBD_BuildRegisterCompositeDevice вызывается драйвером многофакторного устройства USB (составного драйвера), чтобы инициализировать структуру REGISTER_COMPOSITE_DEVICE с информацией, необходимой для регистрации драйвера в стеке USB-драйверов.

Подпрограмма вызывается драйвером, который заменяет составной драйвер, предоставленный корпорацией Майкрософт, 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, полученный в предыдущем вызове подпрограммы USBD_CreateHandle.

[in] CapabilityFlags

Выделенная вызывающим объектом структура COMPOSITE_DEVICE_CAPABILITIES, указывающая возможности, поддерживаемые составным драйвером. Например, чтобы указать, что составной драйвер поддерживает приостановку функции, задайте для элемента CapabilityFunctionSuspend элемент COMPOSITE_DEVICE_CAPABILITIES значение 1.

[in] FunctionCount

Количество объектов физического устройства (PDOS), создаваемых родительским драйвером. Значение FunctionCount не может превышать 255.

[out] RegisterCompositeDevice

Указатель на структуру, выделенную вызывающим объектом REGISTER_COMPOSITE_DEVICE. По завершении структура заполняется указанными сведениями о регистрации. Чтобы зарегистрировать составной драйвер, отправьте запрос IOCTL_INTERNAL_USB_REGISTER_COMPOSITE_DEVICE ввода-вывода и передайте заполненную структуру.

Возвращаемое значение

Никакой

Требования

См. также

IOCTL_INTERNAL_USB_REGISTER_COMPOSITE_DEVICE

REGISTER_COMPOSITE_DEVICE