How To Use Network Setup Debug Extensions to NetDI for Windows ME (282757)


The information in this article applies to:

  • Microsoft Windows Millennium Edition
  • Microsoft Windows ME Driver Development Kit (DDK)
This article was previously published under Q282757

SUMMARY

The network class installer, NetDI.dll, for Windows Millennium (ME) has several diagnostic extensions to assist developers in debugging network setup and installation problems.

MORE INFORMATION

NetDI is the class installer for all network components for Windows ME. During installation, NetDI creates diagnostic information in the NetLog.txt log file in the root directory. The debug/checked build emits extensive diagnostic information to the Kernel debugger, if a debugger is installed. Optionally, during normal operation the debug information can be sent to the NetLog.txt file in addition to the Kernel debugger. This and other options are set through the Registry in this key:

HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Network

A discussion about each option follows.
  • DisableEmitToDebugger (DWORD): If set (to one), debug output is not sent to the Kernel debugger. The default value is zero (0).

  • EnableLogging (DWORD): When set (to one), the debug output is appended to the NetLog.txt log file. By default, logging is disabled.

  • ShowSelectBestCompat (DWORD): When set, NetDI produces a dialog box that shows the compatible driver list during driver selection of a selected device. Device Node and INF information is shown for the most compatible and other compatible drivers. This facility is available only in checked builds of NetDI. By default this is disabled.

  • ShowSelectedDriver (DWORD): When set, NetDI produces a similar dialog box when driver selection completes for a device. This facility is available only in the checked builds of NetDI. By default this is disabled.
Also, if you are analyzing a NetDI problem during the installation or upgrade to Windows ME, the checked build of NetDI.dll can be placed in the same directory as all the other .cab files for Windows ME. This private copy of NetDI.dll overrides the retail copy found in the .cab file. Because Kernel debuggers are not available during an installation or upgrade, diagnostic information is automatically sent to the NetLog.txt log file.

To obtain the checked build of NetDI.dll, see the following article in the Microsoft Knowledge Base:

241517 SAMPLE: Ndis.exe Windows ME NDIS Debug Binaries

To use the checked/debug build of NetDI, copy the file NetDI.dll to your \\Windows\System folder and replace the existing copy. NOTE: Before you copy the NetDI.dll file, you must disable system file protection (SFP); otherwise, the original copy is silently restored. To disable SFP, restart the computer from a DOS or Windows ME startup diskette and then perform the copy. SFP is inactive when you restart the computer from a floppy disk.
Modification Type:MinorLast Reviewed:12/2/2004
Keywords:kbhowto KB282757
©2004 Microsoft Corporation. All rights reserved.