Name | Synopsis | Interface Level | Parameters | Description | Return Values | Context | Examples | Attributes | See Also
#include <sys/usb/usba.h> int usb_get_status(dev_info_t *dip, usb_pipe_handle_t pipe_handle, uint_t request_type, uint_t which, uint16_t *status, usb_flags_t flags);
Solaris DDI specific (Solaris DDI)
Pointer to device's dev_info structure.
Default control pipe handle on which request is made.
bmRequestType. Either:
USB_DEV_REQ_RCPT_DEV — Get device status.
USB_DEV_REQ_RCPT_IF — Get interface status.
USB_DEV_REQ_RCPT_EP — Get endpoint status.
Device, interface or endpoint from which to get status. Either number of interface or endpoint, or 0 if device status requested.
Address into which the status is written.
None are recognized.
The usb_get_status() function returns the status of a device, interface or endpoint. All status requests use the default control pipe. Length of data returned is USB_GET_STATUS_LEN bytes. Always block and wait for resources if not available, regardless of the flags argument.
When the request_type recipient is USB_DEV_REQ_RCPT_DEV, device status is requested. Status returned includes bits for USB_DEV_SLF_PWRD_STATUS (device is currently self-powered) and USB_DEV_RWAKEUP_STATUS (device has remote wakeup enabled). A set bit indicates the corresponding status.
When the request_type is USB_DEV_REQ_RCPT_EP, endpoint status is requested. Status returned includes bits for USB_EP_HALT_STATUS (endpoint is halted). A set bit indicates the corresponding status.
When the request_type is USB_DEV_REQ_RCPT_IF, interface status is requested and USB_IF_STATUS (zero) is returned.
Status returned successfully in the status argument.
Status pointer and/or dip argument is NULL.
Pipe handle is NULL.
Status not returned successfully.
May be called from user or kernel context.
uint16_t status; if (usb_get_status( dip, pipe_handle, USB_DEV_REQ_RCPT_DEV, 0 &status, 0) == USB_SUCCESS) { if (status & USB_DEV_SLF_PWRD_STATUS) { cmn_err (CE_WARN, "%s%d: USB device is running on its own power.", ddi_driver_name(dip), ddi_get_instance(dip)); } }
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE |
ATTRIBUTE VALUE |
---|---|
Architecture |
PCI-based systems |
Interface stability |
Evolving |
Availability |
SUNWusb |
Name | Synopsis | Interface Level | Parameters | Description | Return Values | Context | Examples | Attributes | See Also