Other Registry Entries

In some cases, additional Registry entries are required.

To obtain the performance data for some applications (those that return counters via the DeviceIOControlFile call), it is necessary to use the CreateFile function to open the device associated with the application. In this case, the name specified in CreateFile must also be installed in the DOS Devices node of the Registry:

|

\HKEY_LOCAL_MACHINE
     \SYSTEM
          \CurrentControlSet
               \Control
                    \Session Manager
                         \DOS Devices

For applications that manage multiple device instances with performance data for each device, the application's Services node must have a Linkage key containing an Export value whose data is a list of the device names. For example, a system with two Etherlink cards could have the following Registry entries:

|

\HKEY_LOCAL_MACHINE
     \SYSTEM\CurrentControlSet\Services
          \Elnkii
               \Linkage
                    Export = "\Device\Elnk01" "\Device\Elnk02"
               \Performance
                    Library = "ElnkStat.dll"
                    Open = "OpenElnkStats"
                    Collect = "GetElnkStats"
                    Close = "CloseElnkStats"
          \Elnk01
               Parameters
               Linkage
          \Elnk02
               Parameters
               Linkage

When the Registry controller calls the Open function in an application's performance DLL, the function's argument is a string containing the list of device names from the application's Export value (if present). The Open function can then use these names to determine the devices for which to collect performance data.