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

---

IOUSBDeviceInterface197

Overview

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

Discussion

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

---

Functions

GetBusMicroFrameNumber

Gets the current micro frame number of the bus to which the device is attached.

GetIOUSBLibVersion

Returns the version of the IOUSBLib and the version of the IOUSBFamily.

---

GetBusMicroFrameNumber

---

Gets the current micro frame number of the bus to which the device is attached.

IOReturn ( *GetBusMicroFrameNumber)(
    void *self,
    UInt64 *microFrame,
    AbsoluteTime *atTime);  

Parameters

self

Pointer to the IOUSBDeviceInterface.

microFrame

Pointer to UInt64 to hold the microframe number.

atTime

Pointer to an AbsoluteTime, which should be within 1ms of the time when the bus frame number was acquired.

Return Value

Returns kIOReturnSuccess if successful, kIOReturnNoDevice if there is no connection to an IOService.

Discussion

The device does not have to be open to use this function.

Availability

This function is only available with IOUSBDeviceInterface197 and above.

---

GetIOUSBLibVersion

---

Returns the version of the IOUSBLib and the version of the IOUSBFamily.

IOReturn ( *GetIOUSBLibVersion)(
    void *self,
    NumVersion *ioUSBLibVersion,
    NumVersion *usbFamilyVersion);  

Parameters

self

Pointer to the IOUSBDeviceInterface.

ioUSBLibVersion

Pointer to a NumVersion structure that on return will contain the version of the IOUSBLib.

usbFamilyVersion

Pointer to a NumVersion structure that on return will contain the version of the IOUSBFamily.

Return Value

Returns kIOReturnSuccess if successful, kIOReturnNoDevice if there is no connection to an IOService.

Discussion

The device does not have to be open to use this function.

Availability

This function is only available with IOUSBDeviceInterface197 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