USB Host Client Framework Common Code (Windows Embedded CE 6.0)
1/6/2010
USB Host Client Drivers contain common code for a number of tasks. The USB host client framework library attempts to reduce the amount of duplicate code in USB host client drivers by abstracting these common tasks. The library provides a framework for driver installation and a framework for attaching and detaching devices.
Installation Framework
The installation framework is designed to handle USB driver entries, to setup search entries for the USB stack, and to setup the USB host client driver's registry settings. The following access functions make up the installation framework.
- GetUSBDVersion
- RegisterClientDriverID
- UnRegisterClientDriverID
- RegisterClientSettings
- UnRegisterClientSettings
- OpenClientRegistryKey
- SetDefaultDriverRegistry
- For more information on the usage of the access functions contained in the installation framework, reference the topic USB Host Client Framework Samples.
Attach and Detach Framework
The attach and detach framework is designed to handle device attachment and detachment. The framework also provides callback functions for USBD event notification.
The class UsbClientDevice setus up event notification and parser standard notification, passes notifications to the standard functions, and holds descriptor information. UsbClientDevice also holds all interface information, with each interface holding endpoint information for later use.
The following access function make up the attach and detach framework.
- Init
- GetInterCurface
- GetUniqueDriverId
- IsThisInterfaceSupported
- NumOfInterfaceNeeded
- Attach
- Detach
Note
IsThisInterfaceSupported and NumOfInterfaceNeeded are pure virtual functions that must be implemented. IsThisInterfaceSupported indicates the specific interface the driver wants and NumOfInterfaceNeeded indicates how many interfaces are required to run the user driver.
- For more information on the usage of the access functions contained in the attach and detach framework, reference the topic USB Host Client Framework Samples.