Microsoft Windows CE 3.0  


This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

The HKEY_LOCAL_MACHINE\Drivers\Builtinkey contains subkeys that list which drivers the Device Manager loads when the platform is turned on. Each subkey is named after the device driver and contains values described in the following table. Additional values can be stored for purposes specific to the device driver although drivers should never modify keys outside of the driver's own subkey or keys that the driver did not create itself.

Value name Value type Description
Dll REG_SZ This required entry specifies the file name for a driver DLL that the Device Manager is to load.
Entry REG_SZ This value, if it exists, names an entry point to the DLL. The Device Manager loads the DLL and calls the specified entry point, with the driver's registry path as a parameter. When a driver is invoked in this manner, the driver is responsible for calling the RegisterDevicefunction on its own, and is not tracked by the Device Manager in the Drivers\Activekey.

The function named in this value must follow the prototype specified for PFN_DEV_ENTRY: DWORD(*PFN_DEV_ENTRY)(LPTSTR), where the LPSTRparameter is the registry path of the device's key.

Index REG_DWORD This optional value specifies the device index, a value from 0 through 9, that the Device Manager should assign to the driver. If this value is not present, the Device Manager assigns the lowest available index value as the device driver's device file name index.
Keep REG_SZ This value works in conjunction with the Entryvalue; if you have this value, you must also have the Entryvalue. If this value exists, the Device Manager does not call the FreeLibraryfunction after the entry point specified in the Entryvalue returns. This mechanism exists to provide a means to automatically load DLLs at boot time.
Order REG_DWORD This value specifies the load order for a driver. If two drivers have the same load order value, the drivers load in the order that they occur in the registry. This entry is useful when one driver must load after another. This value is required for non-PC Card devices and is ignored for loading PC Card drivers.
Prefix REG_SZ This required value specifies the driver's device file name prefix. It is a three-character identifier, such as COM.

The following example shows the contents under the Builtinkey for the standard serial port driver.

HKEY_LOCAL_MACHINE [Drivers] [BuiltIn] [Serial]
SZ: Dll = Serial.DLL DWORD: Order = 0x00000000 (0) SZ: Prefix = COM
hex: DevConfig = 10 00 00 00 02 00 00 00 10 01 00 00 00 4b 00
DWORD: DeviceArrayIndex = 0x00000000 (0) DWORD: DeviceType =
0x00000000 (0) SZ: FriendlyName = Serial Cable on COM1: SZ: Tsp =

 Last updated on Tuesday, July 13, 2004

© 2004 Microsoft Corporation. All rights reserved.