Microsoft Knowledge Base Email Alertz

(279356) - The checked build of the Network Driver Interface Specification (NDIS) driver in Windows ME contains debugging options that you can enable in the registry to produce additional kernel debug output. This article describes how to install the checked...

Search KbAlertz

Advanced Search

Receive Microsoft Knowledge Base articles by E-Mail?

Every night we scan the Microsoft Knowledge Base. If technologies you're interested in are updated, we'll send you an e-mail. You only get one e-mail a day, and only when new articles are added.

Click here to create a
FREE account
Already have an account?
[Click here to Login]











Microsoft Knowledge Base Article

This article contents is Microsoft Copyrighted material.
©2005-©2007 Microsoft Corporation. All rights reserved. Terms of Use | Trademarks

Article ID: 279356 - Last Review: September 7, 2005 - Revision: 2.0

NDIS debugging tips for Windows Millennium Edition

System TipThis article applies to a different version of Windows than the one you are using. Content in this article may not be relevant to you. Visit the Windows Vista Solution Center
This article was previously published under Q279356

SUMMARY

The checked build of the Network Driver Interface Specification (NDIS) driver in Microsoft Windows Millennium Edition contains debugging options that you can enable in the registry to produce additional kernel debug output. This article describes how to install the checked build of Ndis.vxd and how to enable additional trace information.

MORE INFORMATION

  1. Install the Windows Millennium Edition kernel debugger according to the instructions in the Driver Development Kit (DDK).
  2. Download the check build NDIS binaries from the following Microsoft Knowledge Base article:
    241517  (http://kbalertz.com/Feedback.aspx?kbNumber=241517/ ) Ndis.exe Windows Millennium Edition NDIS debug binaries
  3. You must disable System File Protection (SFP) before you copy the checked build of Ndis.vxd to the Windows\System folder. You can do this by starting from the Microsoft Windows 98 startup floppy or by starting the system in safe mode. SFP is disabled in safe mode. To start in safe mode, press F8 when Windows Millennium Edition starts, and then select Safe Mode from the menu of boot options.
Four registry entries are available at:
HKLM\System\CurrentControlSet\Services\VxD\NDIS
The four registry entries are:
(DWORD) DebugBreak (Boolean)
(DWORD) TraceImpt (Boolean)
(DWORD) DebugSystems
(DWORD) DebugLevel
					
A description of each entry follows.
  • DebugBreak: Enabling DebugBreak causes NDIS to break into the debugger through an INT 3 when it loads.
  • TraceImpt: The Trace Important flag (TraceImpt) indicates that trace output should be emitted to the debugger. While debugging, this should always be enabled.
  • DebugSystems: DebugSystems identifies which components of NDIS should emit debug trace information. Possible values include:
    INIT		0x00000001
    CONFIG		0x00000002
    SEND		0x00000004
    RECV		0x00000008
    PROTOCOL          0x00000010
    BIND		0x00000020
    BUSINFO		0x00000040
    REG		0x00000080
    MEMORY		0x00000100
    FILTER		0x00000200
    REQUEST		0x00000400
    WORK ITEM         0x00000800
    PNP		0x00001000
    PM		0x00002000
    OPENREF		0x00004000
    LOCKS		0x00008000
    RESET		0x00010000
    WMI		0x00020000
    CO		0x00040000
    REF		0x00080000
    ALL		0xFFFFFFFF
    						
    Note Please be aware that these values differ from similar lists in other versions of Microsoft Windows. Specifically, the list in the following Microsoft Knowledge Base article, which describes NDIS debugging for Microsoft Windows 98:
    232515  (http://kbalertz.com/Feedback.aspx?kbNumber=232515/ ) NDIS level and component debugging flags
    These values can be ORed together to specify multiple components. By default, the following components are pre-selected when TraceImpt is enabled:
    • INIT
    • CONFIG
    • PNP
    • PM
    • PROTOCOL
    • BIND
    • BUSINFO
    • REG
  • DebugLevel: DebugLevel allows you to adjust how much trace information is emitted. INFO level produces the most information, and it is the default value if TraceImpt is enabled. Otherwise, its default value is FATAL. Possible values are:
    INFO		0x00000000
    LOG		0x00000800
    WARN		0x00001000
    ERR		0x00002000
    FATAL		0x00003000
    					
  • NdisTraceAll is a flag, which, if enabled, produces very verbose trace information. It cannot be enabled through a registry entry. You may enable it by causing NDIS to break at startup by using the DebugBreak option, described previously. When NDIS hits the breakpoint, load NDIS' symbols and then set ndistraceall:wa ndis
    e ndistraceall 1

APPLIES TO
  • Microsoft Windows Millennium Edition
  • Microsoft Windows Millennium Edition Driver Development Kit
Keywords: 
kbhowto kbinfo kbndis KB279356
       

Community Feedback System

Very often, it takes hours to solve a problem. Very often, you've looked high and low, and have tried a lot of solutions. When you finally found it, chances are, it was because someone else helped you. Here's your chance to give back. Use our community feedback tool to let others know what worked for you and what didn't.

Please also understand that the community feedback system is not warranted to be correct, it's simply a system that we've built to let people try and help each other. If something in a feedback response doesn't make sense to you, or you're not comfortable making changes that the feedback talks about (like registry edits), please consult a professional.

Thank you for using kbAlertz.com Feedback System.

-- Scott Cate

GEORGE - hinton-rogers NOSPAM-AT-NOSPAM comcast.net Report As Irrelevant  
Written: 7/25/2004 4:32 PM
I always check your email to see if there is something I can use , most of the time there is. I like to thank you. So please don'nt think I'm not looking at your web site because I do. THANKS again for all your information you give out. GEORGE

muhammad - myousufjoukar NOSPAM-AT-NOSPAM yahoo.com Report As Irrelevant  
Written: 11/3/2005 12:06 AM
i can't enable the NDIS. how can it possible i want to use it as a packet filtering and packet redirecting