функция 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 |