Поделиться через


функция 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 , выделенная вызывающим объектом, которая указывает возможности, поддерживаемые составным драйвером. Например, чтобы указать, что составной драйвер поддерживает приостановку функции, задайте для элемента CapabilityFunctionSuspendCOMPOSITE_DEVICE_CAPABILITIES значение 1.

[in] FunctionCount

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

[out] RegisterCompositeDevice

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

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

None

Требования

Требование Значение
Минимальная версия клиента Требуется WDK для Windows 8. Предназначен для Windows Vista и более поздних версий операционной системы Windows.
Целевая платформа Персональный компьютер
Верхняя часть usbdlib.h
Библиотека Usbdex.lib
IRQL < = DISPATCH_LEVEL

См. также раздел

IOCTL_INTERNAL_USB_REGISTER_COMPOSITE_DEVICE

REGISTER_COMPOSITE_DEVICE