USB Function Client Driver Registry Settings (Compact 2013)
3/26/2014
The registry settings for each USB function client driver are in the %_WINCEROOT%\Public\Common\OAK\Files\Common.reg file. To modify these settings for your hardware platform, add the registry keys you need to alter to your hardware platform's Platform.reg file. The Platform.reg file for each platform is in %_WINCEROOT%\Platform\%_TGTPLAT%\Files. Registry keys placed in Platform.reg override matching registry keys in Common.reg.
Note
For all USB function client drivers, in the Platform.reg file for your hardware platform, appropriately update the default Manufacturer and Product strings.
Do not use the platform.reg file to reset the [HKEY_LOCAL_MACHINE\Drivers\USB\FunctionDrivers\DefaultClientDriver] setting unless special behavior is desired.
The following table describes the USB function client driver registry settings common to all USB function client drivers. The USB function client driver registry settings are under [HKEY_LOCAL_MACHINE\Drivers\USB\FunctionDrivers].
Registry key |
Description |
|---|---|
DefaultClientDriver |
Use to specify the default client driver. USBFunctionDriverSubkey is a placeholder string that represents a client driver. Specify a DefaultClientDriver for each type of USB function client. |
USBFunctionDriverSubkey\Dll |
DLL name for the USB function client driver. |
USBFunctionDriverSubkey\DeviceName |
Identifies the name of the store to expose to the USB host. |
USBFunctionDriverSubkey\FriendlyName |
Friendly name for the USB function client. |
USBFunctionDriverSubkey\idVendor |
idVendor must be changed. 045E belongs to Microsoft and is only to be used for prototype devices in your labs. Visit this Web site to obtain a vendor identifier. |
USBFunctionDriverSubkey\Manufacturer |
Name of the USB function client device manufacturer. Replace appropriately. |
USBFunctionDriverSubkey\idProduct |
Product identifier to be defined by the manufacturer. |
USBFunctionDriverSubkey\Product |
Name of the USB function client device. Replace appropriately. |
USBFunctionDriverSubkey\bcdDevice |
USB device's release number, in binary-coded decimal (BCD) format. |
Note
The DefaultClientDriver setting for Composite should not be overwritten by any other registry setting when the SYSGEN_USBFN_COMPOSITE variable is specified.
USB Function Composite Device Driver Registry Settings
The USB Function Composite device driver allows any USB Function client driver to work simultaneously with other USB Function client drivers. To use the USB Function Composite device driver the appropriate registry keys are set as explained below.
First, in order to load the USB Function client driver, you need to designate the USB Function Composite driver as the default client driver.
[HKEY_LOCAL_MACHINE\Drivers\USB\FunctionDrivers]
"DefaultClientDriver"="CompositeFN"
The following table describes the global USB Function Composite client registry settings read by the USB Function Composite device driver. The global USB Function client driver registry settings are set under [HKEY_LOCAL_MACHINE\Drivers\USB\FunctionDrivers\CompositeFN].
Value:Type |
Description |
|---|---|
Attributes:multi_sz |
Attributes for each configuration. Each string is a two digit hexadecimal value. The default setting is for 0x80 and one configuration. |
bcdDevice:dword |
USB function client device's release number, in binary-coded decimal (BCD) format. |
DefaultPrefix:string |
Prefix of the client specific values. The default string value is "CompositeFn_". All client specific value names will be prefixed with this string, ex. "DefaultString" is actually "CompositeFn_DefaultString". |
ManufacturerString:string |
Name of the USB Function client driver manufacturer. Replace appropriately. |
MaxPacketSize:dword |
Maximum packet size for endpoint zero. |
PowerConsumption:multi_sz |
Maximum power consumption for each configuration. Each string is a two digit hexadecimal value. The default setting is for one configuration with 0 mA. |
ProductID:dword |
Product Identifier of the USB function client device to be defined by the manufacturer. |
ProductString:string |
Name of the USB function client device. Replace appropriately. |
SerialString:string |
Serial number of the USB function client device. Replace appropriately. |
VendorID:dword |
VendorID must be changed. 045E belongs to Microsoft and is only to be used for prototype devices in your labs. Visit this Web site to obtain a vendor identifier. |
The following table describes the client specific USB Function client registry settings read by the USB Function Composite device driver. All of the registry values in this table begin with a prefix that is defined by the DefaultPrefix value of the USB Composite Function client driver registry settings. By default, the prefix for these values is "CompositeFn_". The client specific USB Function client driver registry settings are set under [HKEY_LOCAL_MACHINE\Drivers\USB\FunctionDrivers\<UsbFnClient>].
Value:Type |
Description |
|---|---|
<DefaultPrefix>Configurations:multi_sz |
Indicates the client configuration to use for a specific composite configuration. Each string is a two digit hexadecimal value (client driver configuration index) or "X". An "X" indicates that the client should be excluded from a specific composite configuration. If nothing is specified, the default configuration of client drivers will be included in all composite configurations |
<DefaultPrefix>DefaultClient:dword |
The DefaultClient default value is 0. A value of 1 indicates that this client is a default client. When processing USB Function controller notifications, the USB Function Composite device driver will try to determine what client should get the notification. The default client (if specified) will get the notification if the USB Function Composite device driver was unable to determine the correct recipient for the notification. |
<DefaultPrefix>DefaultString:string |
String used when the string in a specific language string was not provided. |
<DefaultPrefix>FunctionClass:dword |
Function class code |
<DefaultPrefix>FunctionDescription:string |
String describing this function. |
<DefaultPrefix>FunctionProtocol:dword |
Function protocol code. |
<DefaultPrefix>FunctionSubclass:dword |
Function subclass code. |
If the FunctionClass, FunctionSubclass, FunctionProtocol and FunctionDescription values are not specified in the registry, the USB Function Composite device driver will use the class, subclass and protocol codes from the first interface of the client device.
The sequence in which the USB Function client drivers are loaded is controlled by setting the [HKEY_LOCAL_MACHINE\Drivers\USB\FunctionDrivers\CompositeFN\ClientDriverList] registry key as follows:
[HKEY_LOCAL_MACHINE\Drivers\USB\FunctionDrivers\CompositeFN]
ClientDriverList=multi_sz:"ClientA;ClientB;ClientC"
The above registry setting loads ClientA, then Client B, and then ClientC. If the multi_sz string is provided then it determines which USB Function client drivers are loaded and the order in which they are loaded. However, if this multi_sz key is not present, then it will be created by scanning through all the USB Function client drivers and entering them in the order they are enumerated in the configuration registry file.
On a parallel note, by default all USB Function client drivers, specified in the multi_sz key, will be loaded by the USB Function Composite device driver. If you do not want a particular USB Function client driver to be loaded, then you need to set the CompositeFn_Disable key under that specific USB Function Client driver's registry key to 1 as shown below.
[HKLM\Drivers\USB\FunctionDrivers\<USBFnClient>]
CompositeFn_Disable = DWORD:1
Essentially, two factors determine which USB Function client drivers are loaded. The first factor is whether or not the ClientDriverList multi_sz registry key is specifically set or if it is allowed to take on default settings. The second factor is whether the individual USB Function client driver has been disabled using the CompositeFn_Disable key. Based on these factors, all USB Function client drivers are loaded by default unless the individual USB Function client drivers has the CompositeFn_Disable key set to prevent their loading or the ClientDriverList multi_sz string is explicitly set to exclude a specific USB Function client driver.
The ClientDriverList multi_sz registry key simplifies the process of determining which USB Function client drivers to load. This key allows the system developer to change the USB Function client drivers loaded on a device, without having to walk through all the USB Function client drivers in the system and edit their specific registry settings. Through this system it is possible to accomplish the dynamic loading and unloading of individual USB Function client drivers.
Dynamic loading and unloading of individual client drivers
Dynamic loading and unloading of individual client drivers is still supported and can easily be accomplished using the ClientDriverList multi_sz registry key mentioned above.
Under previous version of the operating system, before the addition of the USB Function Composite device driver, switching to a different client could be accomplished by changing the protocol used by the device. For example, under Windows CE 5.0, the user can choose at run time whether the Windows Embedded Compact powered device uses the USB RNDIS, USB Serial, or USB Function Mass Storage client driver. In this scenario, the current client is stopped, unloaded, and a new USB Function client driver is loaded in its place.
With the addition of the USB Function Composite device driver this scenario has changed. Now, there is little need to switch USB Function client drivers since the device can use multiple protocols at the same time. However, if the system owner decides to dynamically change the USB Function client drivers on the device, due to a hardware limitation like the number of USB end points, then the process is straight forward. The system owner just sets the ClientDriverList multi_sz registry key, to represent the required USB Function client drivers, and then calls the USB Function controller with the IOCTL_UFN_CHANGE_CURRENT_CLIENT IOCTL code. The USB Function controller then unloads the USB Function Composite device driver, as well as all the USB Function client drivers. Subsequently, the USB Function controller switches to either the USB Function Composite device driver, running a different set of USB Function client drivers, or else to a different noncomposite USB Function client driver. Upon reload, unless a noncomposite USB Function client driver was chosen, the USB Function controller loads the USB Function Composite device driver, which in turn loads the USB Function client driver specified by the ClientDriverList multi_sz registry key. This process effectively allows the system developer to change the USB Function protocols of a device dynamically.
USB Function Mass Storage Client Driver Registry Settings
The following table describes the USB function mass storage client driver registry settings. The USB function mass storage client driver registry settings are under [HKEY_LOCAL_MACHINE\Drivers\USB\FunctionDrivers\Mass_Storage_Class].
Registry key |
Description |
|---|---|
InterfaceSubClass |
USB host uses this value to identify the class of an enumerated device. 06h corresponds to the USB mass storage client. |
InterfaceProtocol |
USB-IF defined value that the USB host uses to determine the USB mass storage transport protocol supported by the device. 50h corresponds to bulk-only transport (BOT). |
The following registry keys show the default USB function mass storage client driver registry settings.
[HKEY_LOCAL_MACHINE\Drivers\USB\FunctionDrivers]
"DefaultClientDriver"=- ; erase previous default
[HKEY_LOCAL_MACHINE\Drivers\USB\FunctionDrivers]
"DefaultClientDriver"="Mass_Storage_Class"
[HKEY_LOCAL_MACHINE\Drivers\USB\FunctionDrivers\Mass_Storage_Class]
"Dll"="usbmsfn.dll"
"InterfaceSubClass"=dword:06
"InterfaceProtocol"=dword:50
"DeviceName"="DSK1:"
"FriendlyName"="Mass Storage"
"idVendor"=dword:045E
"Manufacturer"="Generic Manufacturer (PROTOTYPE--Remember to change idVendor)"
"idProduct"=dword:FFFF
"Product"="Generic Mass Storage (PROTOTYPE--Remember to change idVendor)"
"bcdDevice"=dword:0
USB Function Serial Client Driver Registry Settings
The following table describes the USB function serial client driver registry settings. The USB function serial client driver registry settings are under [HKEY_LOCAL_MACHINE\Drivers\USB\FunctionDrivers\Serial_Class].
Registry key |
Description |
|---|---|
DeviceArrayIndex |
Use to load different USB function serial client driver objects. |
USB_OutTransferSize |
Sets the size of the buffer used to receive data during a call to the USB function controller driver. The default buffer size is 0x1000. |
USB_InTransferSize |
Sets the size of the buffer used to send data during a call to the USB function controller driver. The default buffer size is 0x1000. |
The following registry keys show the default USB function serial client driver registry settings.
[HKEY_LOCAL_MACHINE\Drivers\USB\FunctionDrivers]
"DefaultClientDriver"=- ; erase previous default
[HKEY_LOCAL_MACHINE\Drivers\USB\FunctionDrivers]
"DefaultClientDriver"="Serial_Class"
[HKEY_LOCAL_MACHINE\Drivers\USB\FunctionDrivers\Serial_Class]
"Dll"="serialusbfn.dll"
"DeviceName"="USBFNS1:"
"Prefix"="COM"
"DeviceArrayIndex"=dword:0 ; Use to load different USB function serial client driver objects.
"RxBufferSize"=dword:4000
"IClass"="{CC5195AC-BA49-48a0-BE17-DF6D1B0173DD}"
; idVendor must be changed. 045E belongs to Microsoft and is only to be used for
; prototype devices in your labs. Visit http://www.usb.org to obtain a vendor id.
"idVendor"=dword:045E
"Manufacturer"="Generic Manufacturer (PROTOTYPE--Remember to change idVendor)"
"idProduct"=dword:00ce
"Product"="Generic Serial (PROTOTYPE--Remember to change idVendor)"
"bcdDevice"=dword:0
"CompositeFn_DefaultClient"=dword:0
; "USB_OutTransferSize"=dword:1000 ; 0x1000 is the default vaule for the In and Out transfers for serialusbfn
; "USB_InTransferSize"=dword:1000 ;
[HKEY_LOCAL_MACHINE\Drivers\USB\FunctionDrivers\Serial_Class\Unimodem]
"Tsp"="Unimodem.dll"
"DeviceType"=dword:0
"DevConfig"=hex: 10,00, 00,00, 05,00,00,00, 10,01,00,00, 00,4B,00,00, 00,00, 08, 00, 00, 00,00,00,00
[HKEY_LOCAL_MACHINE\Drivers\USB\FunctionDrivers\USBSER_Class]
"Dll"="serialusbfn.dll"
"DeviceName"="USBFNS2:"
"Prefix"="COM"
"DeviceArrayIndex"=dword:1
"RxBufferSize"=dword:4000
"IClass"=multi_sz:"{CC5195AC-BA49-48a0-BE17-DF6D1B0173DD}","{C375C787-B721-4b8e-B67F-A112D5C0A404}"
"idVendor"=dword:045E
"Manufacturer"="Generic Manufacturer (PROTOTYPE--Remember to change idVendor)"
"idProduct"=dword:0079
"Product"="Generic Serial (PROTOTYPE--Remember to change idVendor)"
"bcdDevice"=dword:90
; "USB_OutTransferSize"=dword:1000 ; default vaule of 4k on OUT transfers for SERIALUSBFN can be changed here.
; "USB_InTransferSize"=dword:1000 ; default vaule of 4k on IN transfers for SERIALUSBFN can be changed here.
[HKEY_LOCAL_MACHINE\Drivers\USB\FunctionDrivers\USBSER_Class\Unimodem]
"Tsp"="Unimodem.dll"
"DeviceType"=dword:0
"DevConfig"=hex: 10,00, 00,00, 05,00,00,00, 10,01,00,00, 00,4B,00,00, 00,00, 08, 00, 00, 00,00,00,00
USB Function RNDIS Client Driver Registry Settings
The following table describes the USB function RNDIS client driver registry settings. The USB function RNDIS client driver registry settings are under [HKEY_LOCAL_MACHINE\Drivers\USB\FunctionDrivers\RNDIS].
Registry key |
Description |
|---|---|
UseActiveSyncIds |
If this value is set to anything besides zero (0), RNDIS sets the Device Class, Device Subclass, and Device Protocol codes in the USB device descriptor and interface descriptor to the values recognized by ActiveSync on the desktop computer. If this value is not in the registry or is set to 0, the standard communication class values are used. |
Priority256 |
Determines the priority of incoming packets for RX thread processing. |
The following registry keys show the default USB function RNDIS client driver registry settings.
[HKEY_LOCAL_MACHINE\Drivers\USB\FunctionDrivers]
"DefaultClientDriver"=- ; erase previous default
[HKEY_LOCAL_MACHINE\Drivers\USB\FunctionDrivers]
"DefaultClientDriver"="RNDIS"
[HKEY_LOCAL_MACHINE\Drivers\USB\FunctionDrivers\RNDIS]
"UseActiveSyncIds"=dword:1
[HKEY_LOCAL_MACHINE\Drivers\USB\FunctionDrivers\RNDIS]
"Dll"="rndisfn.dll"
"FriendlyName"="Rndis"
"idVendor"=dword:045E
"Manufacturer"="Generic Manufacturer (PROTOTYPE--Remember to change idVendor)"
"idProduct"=dword:0301
"Product"="Generic RNDIS (PROTOTYPE--Remember to change idVendor)"
"bcdDevice"=dword:0