USBD_REGISTER_MULTI_HC

Purpose

Register USB Host Controller with USB system driver.

Syntax

int ioctl (file, USBD_REGISTER_MULTI_HC, arg)

Parameter

Item Description
file File descriptor that are obtained when the USBD special file was opened.
arg Pointer to USB host controller information structure.

Description

If successful, this ioctl registers the all USB host controller listed in the usb_adapterhc_info structure with the USBD and allow clients to talk to devices connected to the controller. There is no specific IOCTL to unregister a hardware controller. It stays registered until either the USBD is unconfigured or the host controller is unconfigured. In the latter case, the host controller driver asks the USBD to unregister the host controller through a call vector usbdReqHCunregister.

This ioctl should be invoked only by the cfgusb config method during enumeration and individual USB adapter configuration methods should use USBD_REGISTER_SINGLE_HC for registering single host controller instance.

Execution Environment

This function might be called from the user process environment only.

Return Values

Value Description
0 Indicates successful completion.
-1 Failure (check errno for specific failure)