ADC Home > Reference Library > Reference > Hardware & Drivers > I/O Kit Framework Reference

---

IOUSBDeviceInterface187

Overview

The object you use to access USB devices from user space, returned by the IOUSBFamily version 1.8.7 and above.

Discussion

The functions listed here include all of the functions defined for the IOUSBDeviceInterface, IOUSBDeviceInterface182, and some new functions that are available on Mac OS X version 10.1.2 and later.

---

Functions

USBDeviceReEnumerate

Tells the IOUSBFamily to reenumerate the device.

---

USBDeviceReEnumerate

---

Tells the IOUSBFamily to reenumerate the device.

IOReturn ( *USBDeviceReEnumerate)(
    void *self,
    UInt32 options);  

Parameters

self

Pointer to the IOUSBDeviceInterface.

options

A UInt32 reserved for future use. Ignored in current implementation. Set to zero.

Return Value

Returns kIOReturnSuccess if successful, kIOReturnNoDevice if there is no connection to an IOService, or kIOReturnNotOpen if the device is not open for exclusive access.

Discussion

This function will send a terminate message to all clients of the IOUSBDevice (such as IOUSBInterfaces and their drivers, as well as the current User Client), emulating an unplug of the device. The IOUSBFamily will then enumerate the device as if it had just been plugged in. This call should be used by clients wishing to take advantage of the Device Firmware Update Class specification. The device must be open to use this function.

Availability

This function is only available with IOUSBDeviceInterface187 and above.

Did this document help you? Yes: Tell us what works for you. It’s good, but: Report typos, inaccuracies, and so forth. It wasn’t helpful: Tell us what would have helped.

 

Last Updated: 2009-02-23