Compuware DriverStudio

Release 2.7

 

CONTENTS

 

What is DriverStudio?

DriverStudio is a suite of tools that simplifies development, debugging, and testing of device drivers for Microsoft Windows. The following tools are included in the complete DriverStudio release.

SoftICE

SoftICE is a powerful system-wide debugger that supports source level debugging of any software, driver, service, and most bios code on either a single or dual machine configuration. SoftICE not only debugs SYS files and VxDs, but also can debug Ring 3 applications as well as system internals and through-ring transitions.

DriverWorks

DriverWorks includes a complete framework for device driver development for both Windows NT 4 and Win32 Driver Model (WDM) drivers. DriverWorks includes a sophisticated code-generation tool (DriverWizard) along with class libraries and sample drivers that support the development of device drivers in C++.

DriverNetworks

DriverNetworks is a suite for Windows network driver developers. In its core, DriverNetworks is a C++ class library for NDIS drivers and TDI clients (DriverSockets). DriverNetworks also comes with the Network Driver Wizard  to jump start an NDIS Miniport, Intermediate, or Protocol Driver project. It allows you to quickly generate all the files necessary to build, install, and debug your NDIS driver written using the DriverNetworks C++ class library.

VTOOLSD

VTOOLSD supports device driver (VxD) development for Win9X (Windows 95 and Windows 98) systems. VTOOLSD includes code-generation tools, run-time and interface libraries, and an extensive collection of sample drivers that can be used as the basis for a wide variety of device drivers.

DriverWorkbench

DriverWorkbench provides visibility into system crash dump files and live events. Integrated with BoundsChecker Driver Edition, DriverWorkbench exposes data collected by BoundsChecker Driver Edition before a system crash or as it is logged. This unique view of the system offers an unprecedented ability to identify problems by viewing a trace of system activity that precedes a crash.

BoundsChecker Driver Edition

BoundsChecker Driver Edition provides parameter validation and system instrumentation that can monitor and track all interactions between various device drivers and other operating system components. The Configuration Wizard provides fine-tuned control over the type and amount of information that BoundsChecker Driver Edition collects.

TrueTime Driver Edition

TrueTime Driver Edition is a performance analysis tool that allows Windows NT/2000/XP device driver writers to identify and fix a driver's performance bottlenecks. TrueTime Driver Edition has been engineered to meet the needs of device driver and kernel-mode code developers. The Configuration Wizard provides control over which drivers and functions to profile. DriverWorkbench is the interface for analyzing results collected by TrueTime Driver Edition.

TrueCoverage Driver Edition

The best way to make sure you test all your code is to use a coverage tool. TrueCoverage Driver Edition helps you detect which parts of your code have been tested, and which still need to be tested. You can save testing time and improve code reliability by measuring and tracking code execution and stability during development. TrueCoverage makes it easy to collect coverage data for your driver, view that data in the context of your source code, and merge data accumulated over multiple sessions.

DriverAgent

DriverAgent is not included with this release.

FieldAgent

FieldAgent is no longer available as a separate selection on the DriverWorkbench menu. Its functionality has been incorporated into the Unified Configuration Dialog.

Note:  While we recommend that you develop drivers with DriverWorks or VToolsD, the DriverStudio tools are also designed to work well with the Microsoft DDK.

Return to:

CONTENTS

 

What's New in This Release?

Note:  You can verify that you have Release 2.7 installed on your computer by issuing the ver command at the SoftICE command line prompt.

Return to:

CONTENTS

 

Symbol Retriever

DriverStudio now ships with a tool which will allow for retrieval of symbols from any Symbol Server Site. The purpose of Symbol Retriever is to download debug files from a Symbol Server site and optionally translate and load the information into SoftICE.

Symbol retriever can be run on any operating system. It will retrieve symbols for any Windows NT based operating system. All you need are the binaries from the original OS. For example, Symbol Retriever can be run on a Win2K system and retrieve symbols for WinXP system.  

This program has the ability to access any Symbol Server Site.  By default it will download from the Microsoft Symbol Server site.

 

Return to:

What's New in this Release?

CONTENTS

 

SoftICE

New Features

 SET TYPEFORMAT 1 is <type> <variable name> = <value>     

 SET TYPEFORMAT 2 is the default <variable name> <type> = <value>    

 SET TYPEFORMAT 3 is  <variable name> = <value> <type>.

Bug Fixes

Note:  For new bug fixes and additional information, see the SoftICE Readme.

 

Return to:

What's New in this Release?

CONTENTS

 

DriverWorks

Note:  You can use DriverWorks to build 64-bit drivers for the Windows XP 64-bit operating system. (For build details, please refer to the DriverWorks Help topic, Building Drivers with the XP DDK.)

Note:  This release provides limited support for VS. NET IDE. Neither the Driver Wizard nor any other DriverStudio add-on buttons are supported inside the IDE. No 64-bit configurations are supported.

Bug Fixes

Note:  For new bug fixes, see the DriverWorks Readme.

 

Return to:

What's New in this Release?

CONTENTS

 

DriverNetworks

Note:  You can use DriverNetworks to build 64-bit drivers for the Windows XP 64-bit operating system. (For build details, please refer to the DriverNetworks Help topic, Building Drivers with the XP DDK.)

Note:  This release provides limited support for VS. NET IDE. Neither the Network Driver Wizard nor any other DriverStudio add-on buttons are supported inside the IDE. No 64-bit configurations are supported.

Bug Fixes

Note:  For new bug fixes, see the DriverNetworks Readme.

 

Return to:

What's New in this Release?

CONTENTS

 

VTOOLSD

Note:  See the VtoolsD Readme for recent VTOOLSD bug fixes.

 

Return to:

What's New in this Release?

CONTENTS

 

DriverWorkbench

Bug Fixes

Note:  For new bug fixes, see the DriverWorkbench Readme.

 

Return to:

What's New in this Release?

CONTENTS

 

BoundsChecker for Drivers

New Features

Note:  See the Readme Archive for other BoundsChecker features recently introduced.

Note:  Due to the increased number of events that BoundsChecker can log, a limitation has been placed on the number of drivers BoundsChecker can watch.

Bug Fixes

 

Return to:

What's New in this Release?

CONTENTS

 

TrueTime for Drivers

New Features

Note:  See the Readme Archive for other TrueTime features recently introduced.

Bug Fixes

 

Return to:

What's New in this Release?

CONTENTS

 

TrueCoverage for Drivers

New Features

Note:  See the Readme Archive for other TrueCoverage features recently introduced.

Bug Fixes

Note:  For new bug fixes, see the TrueCoverage Readme.

 

Return to:

What's New in this Release?

CONTENTS

 

Hardware and Software Requirements

It is a good idea to backup your system before you install the product. The following items are required to install and run DriverStudio.

Return to:

CONTENTS

 

Installation Notes

Important:  All previous versions of DriverStudio must be COMPLETELY uninstalled prior to the installation of this software.

Installing DriverStudio

DriverStudio 2.7 has a install program based on the Microsoft Windows Installer. This install program provides three main installation options:

Unified Configuration Dialog

The Unified Configuration Dialog helps you configure your DriverStudio components. Help is available for all settings in this dialog. (See also "Configuring DriverStudio Components.")

Disabling Remote Access

Remote access to a target machine can now be disabled by unchecking ‘Allow remote access’ in the RemoteAccess/Security page on the Unified Configuration Dialog. A reboot is required to apply the change.

Removing the DriverStudio Namespace Extension

The installation of DriverWorkbench or SoftICE will place an icon on the desktop called DriverStudio Remote Data. This icon is not a shortcut. It is a Namespace Extension  and is used by the DriverWorkbench and SoftICE distributed components. If you will not be connecting to any remote computers running DriverStudio, you can safely remove the Namespace Extension and the icon on the desktop by running regsvr32 /u DSRNamespace.dll. (See the DriverWorkbench readme for a more detailed description of the DriverStudio Namespace Extension.)

 

Removing a DriverStudio Installation

To remove DriverStudio, use the Add/Remove Programs applet in the Control Panel. Choose the components that you want to remove. Removing DriverStudio performs the following actions.

Note:  After you uninstall DriverStudio, it is a good idea to reboot your system.

 

What to Install

In some cases you might want to develop and test on the same system. In other cases, you might want to test your device drivers on a system separate from your development machine. Install one or more of the following tools on your development system:

Install the following tools on your test system (can be the same machine as your development system):

Note:  Your license agreement permits you to use the DriverStudio on two machines only if you are the sole user of both machines.

Return to:

CONTENTS

 

Configuring DriverStudio Components

The Unified Configuration Dialog controls settings for all DriverStudio configurable components including SoftICE and BoundsChecker. It is accessible from the DriverStudio and SoftICE program menus. It is also accessible from within DriverWorkbench under Tools/Settings. The configuration dialog can be used to modify settings on both local and remote machines. This functionality is also available from the command line using the –target MachineName command line switch. The Remote Access/Security page has been added to the configuration dialog. This allows the user to control security settings on a target machine. These settings include the ability to deny all remote connections to a target machine as well as to deny remote reboot access for a target machine. Help is now available for all dialog settings. If you want to analyze crash dump files, be sure to see Analyze Crash Dump Files in the DriverWorkbench online Help.

Return to:

CONTENTS

 

Where to Find Help and Documentation

Note:  DriverStudio documentation is presented in Adobe PDF format. If you have not yet installed the Adobe Acrobat Reader on your system, you can find the setup at http://www.adobe.com/products/acrobat/readstep2.html.

SoftICE

\Compuware\DriverStudio\SoftICE\Using SoftICE.pdf and \Compuware\DriverStudio\SoftICE\SoftICE Command Reference.pdf are online versions of the manuals. \Compuware\DriverStudio\ Help\CommRef.chm is a help file version of the SoftICE Command Reference document. You can access SoftICE Command Reference help from the Start menu. The readme.htm file describes recent changes.

BoundsChecker Driver Edition

\Compuware\DriverStudio\SoftICE\Using SoftICE.pdf describes how to use BoundsChecker Driver Edition with SoftICE. \Compuware\DriverStudio\Help\sysalyze.chm describes how to use BoundsChecker Driver Edition with DriverWorkbench. You can use the Help buttons in the Configuration Wizard to get help for each step.

TrueTime Driver Edition

\Compuware\DriverStudio\Help\sysalyze.chm describes how to use TrueTime Driver Edition with DriverWorkbench.

TrueCoverage Driver Edition

\Compuware\DriverStudio\Tcd\TrueCoverage Getting Started.pdf describes how to use TrueCoverage Driver Edition with DriverStudio. \Compuware\DriverStudio\Help\CovMain.chm is the help system for TrueCoverage Driver Edition.

Tools

\Compuware\DriverStudio\Help\tools.chm describes how to use the DriverStudio Tools.

DriverWorkbench

\Compuware\DriverStudio\Help\sysalyze.chm is the help system for DriverWorkbench. You can access the help system from within the tool using the Help menu, Help buttons, and F1. The readme.htm file describes recent changes.

DriverWorks

\Compuware\DriverStudio\DriverWorks\Using DriverWorks.pdf is the online version of the manual. \Compuware\DriverStudio\Help\vdw.chm is the help system for DriverWorks. You can access the help system from the Start menu. The readme.htm file describes recent changes.

DriverNetworks

\Compuware\DriverStudio\Help\dnw.chm is the help system for DriverNetworks. You can access the help system from the Start menu. The readme.htm file describes recent changes.

VTOOLSD

\Compuware\DriverStudio\VtoolsD\Using VtoolsD.pdf is the online version of the manual. \Compuware\DriverStudio\Help\vtd95.chm is the help system for VTOOLSD. You can access the help system from the Start menu. The readme.htm file describes recent changes.

 

Return to:

CONTENTS

 

Important Release Information

DriverStudio

The following notes pertain to DriverStudio.

  Select Network Connections from the Start-Settings menu.

  Right click on your network icon and select properties.

  Under the Advanced tab, uncheck Internet Connection Firewall.

SoftICE

The following notes pertain to SoftICE.

Frameworks (DriverWorks & DriverNetworks)

The following notes pertain to Frameworks.

LINK: fatal error LNK1207: incompatible PDB format in ; delete and rebuild.

This is a linker glitch due to incompatible PDB formats used by the VC 6.0 and XP DDK build environments. To get around this, you have to manually delete the specified .pdb file and rebuild the project.

DriverWorkbench

The following notes pertain to DriverWorkbench.

BoundsChecker

The following notes pertain to BoundsChecker.

TrueTime

The following notes pertain to TrueTime.

Return to:

CONTENTS

 

Contacting Technical Support

For Non-Technical Issues

Customer Service is available to answer any questions you might have regarding upgrades, serial numbers and other order fulfillment needs. Customer Service is available from 8:30am to 5:30pm EST, Monday through Friday. Call:

For Technical Issues

Technical Support can assist you with all your technical problems, from installation to troubleshooting. Before contacting Technical Support, please read the relevant sections of the product documentation and the Readme files.

You can contact Technical Support by:

nashua.support@compuware.com

http://frontline.compuware.com/nashua/

1-603-578-8401

*Installation Issues:  Technical Support handles installation and setup issues free of charge.

When contacting Technical Support, please have the following information available:

 

Return to:

CONTENTS

 

Readme Archive

Note:  This section contains README information from the previous releases of Compuware DriverStudio.

Directory of Previous Releases

========================================

NuMega DriverStudio

Release 2.6

 

CONTENTS

 

What's New in This Release?

Note:  You can verify that you have Release 2.6 installed on your computer by issuing the ver command at the SoftICE command line prompt.

Release 2.6 offers enhancements for the following DriverStudio components:

Return to:

CONTENTS

 

SoftICE

New Features

Note:  See the Readme Archive for the SoftICE commands and features introduced in Release 2.5.

 

Return to:

What's New in this Release?

CONTENTS

 

DriverWorks

New Features

Note:  You can use DriverWorks to build 64-bit drivers for the Windows XP 64-bit operating system. (For build details, please refer to the DriverWorks Help topic, Building Drivers with the XP DDK.)

 

Bug Fixes

 

Return to:

What's New in this Release?

CONTENTS

 

DriverNetworks

New Features

Note:  You can use DriverNetworks to build 64-bit drivers for the Windows XP 64-bit operating system. (For build details, please refer to the DriverNetworks Help topic, Building Drivers with the XP DDK.)

 

Bug Fixes

 

Return to:

What's New in this Release?

CONTENTS

 

VTOOLSD

Bug Fixes

Note:  See the Readme Archive for the VTOOLSD bug fixes introduced in Release 2.5.

 

Return to:

What's New in this Release?

CONTENTS

 

DriverWorkbench

New Features

Note:  See the Readme Archive for the DriverWorkbench commands and features introduced in Release 2.5.

 

Bug Fixes

 

BoundsChecker for Drivers

New Features

Bug Fixes

 

Return to:

What's New in this Release?

CONTENTS

 

 

Important Release Information

DriverStudio

The following notes pertain to DriverStudio.

  Select Network Connections from the Start-Settings menu.

  Right click on your network icon and select properties.

  Under the Advanced tab, uncheck Internet Connection Firewall.

SoftICE

The following notes pertain to SoftICE.

Frameworks (DriverWorks & DriverNetworks)

The following notes pertain to Frameworks.

LINK: fatal error LNK1207: incompatible PDB format in ; delete and rebuild.

This is a linker glitch due to incompatible PDB formats used by the VC 6.0 and XP DDK build environments. To get around this, you have to manually delete the specified .pdb file and rebuild the project.

DriverWorkbench

The following notes pertain to DriverWorkbench.

 

Return to:

CONTENTS

 

 

========================================

NuMega DriverStudio

DriverStudio Release 2.5

 

CONTENTS

What's New in This Release?

Important Notes

Readme Archive

 

What's New in This Release?

Note:  You can verify that you have Release 2.5 installed on your computer by issuing the ver command at the SoftICE command line prompt.

Release 2.5 offers enhancements for the following DriverStudio components:

 

SoftICE

New Features

Note:  The SoftICE Universal Network Driver (UND) is only supported on Win2K.

Note:  Remote debugging can now be done at boot time on Win9x systems.

New/Updated Commands

Bug Fixes

 

VTOOLSD

Bug Fixes

 

DriverWorks

New Features

Note:  You can use DriverWorks 2.5 to build 64-bit drivers for the Windows XP 64-bit operating system. (For build details, please refer to the following topic in the DriverWorks Help: “Building Drivers with the XP DDK.”)

New Sample Drivers

New Classes

New Methods

Bug Fixes

 

DriverNetworks

New Features

Note:  You can use DriverNetworks 2.5 to build 64-bit drivers for the Windows XP 64-bit operating system. (For build details, please refer to the DriverNetworks Help topic, “Building Drivers with the XP DDK.")

New Sample Drivers

New Classes

New Methods

Bug Fixes

 

DriverWorkbench

New Features

Bug Fixes

 

BoundsChecker

New Features

Bug Fixes

 

Important Notes

Problems Printing from Help The online HTML-help files associated with the DriverStudio products allow you to print help topics. You can choose to print a single topic, or to print all topics under a selected heading. Selecting the second choice (printing all topics under a selected heading) will sometimes result in the display of an error-message dialog. This is a bug in the HTML-help development tools, which should be fixed in a future release. (Note that the topics are still printed correctly, you just have to click your way through one or more annoying error-message dialogs to make them go away.) Printing a single topic proceeds with no errors.

 

 

 

========================================

NuMega DriverStudio

Release 2.0.1

IMPORTANT:  If you use SoftICE on machines with power management enabled, you must manually configure SoftICE to support Standby/Resume. See details in the SoftICE README file.

 

CONTENTS
What's New in This Release?
Important Notes
 

What's New in This Release?

NOTE:  You can verify that you have Release 2.0.1 installed on your computer by issuing the ver command at the command line prompt.

Release 2.0.1 offers enhancements and bug fixes for the following DriverStudio components:

 

SoftICE

Enhancements

Bug Fixes

 

BoundsChecker

Bug Fixes

DriverWorkbench

Bug Fixes

DriverWorks

Bug Fixes

DriverNetworks

Important Notes

The following notes pertain to DriverStudio.

Set the item to 1 to enable patching; set it to 0 to disable patching. (The item is of type REG_DWORD.) Note that you must reboot for the change to take effect. This feature was added to deal with instances in which the time consumed by dispatch functions overshadow the times in those other driver functions for which you are trying to collect data.

 

Copyright 2001  Compuware Corporation

1/01

========================================

 

NuMega DriverStudio

Release 2.0

IMPORTANT NOTE:  

If you use SoftICE on machines with power management enabled, you must manually configure SoftICE to support Standby/Resume. See details in the SoftICE README file.

CONTENTS

What's New in This Release?
Important Notes

 

 

What's New in This Release?

DriverStudio supports installing SoftICE and BoundsChecker for drivers on an Embedded NT test machine. After using the Component manager to add in the DriverStudio.kdf you can then configure BoundsChecker and NTICE. Go to 'DriverStudio Easy Installations' . From there you can choose to add support for BoundsChecker and/or SoftICE. If you are debugging on a headless system, you can choose this option. However, you will need a serial cable and your development machine must have sinet.exe installed. To change the configuration of SoftICE/BoundsChecker, right click on the component you need to configure and select the 'properties' item.

 

 

Important Notes

 

 

 

Copyright 2000 Compuware Corp.

5/00

========================================

END OF ARCHIVE

 

Return to:

CONTENTS

 

Copyright 2002 Compuware Corporation