INFO: NDIS Level and Component Debugging Flags

ID: Q232515


The information in this article applies to:


SUMMARY

There is additional Network Driver Interface Specification (NDIS) debugging information available in Windows 98 and Windows 98 SE. This article describes how to access that additional information using the global symbols, ndisdebuglevel and ndisdebugsystems.


MORE INFORMATION

Listed below are level and component NDIS debugging flags. These flags are set through the debugger, and provide trace information as execution passes through NDIS. These flags can be ORed together.

Execute the WDEB386 or WDEB98 debugger with the /B option to break the debugger after driver loading finishes and before VMM initialization begins. At the break, set the NDIS trace important flag, and go:


e ndistraceimpt 1 
After returning from WrapperSyCriticalInit, break into the system and set the ORed value of the trace information in which you are interested. Enter the ORed value in Intel byte order. Use of these flags requires the Windows 98/SE debug binary version of the Ndis.vxd device driver.

EXAMPLE: Set the level trace information for ERROR in the debugger in the following manner:

e ndisdebuglevel 00 20 00 00 
Level Descriptions Value
INFORMATION 0x00000000
LOG 0x00000800
WARNING 0x00001000
ERROR 0x00002000
FATAL 0x00003000


EXAMPLE: Set the component trace information for RECEIVE and SEND in the debugger in the following manner:

e ndisdebugsystems 0C 00 00 00 
Component Descriptions Value
INITIALIZE 0x00000001
CONFIGURATION 0x00000002
SEND 0x00000004
RECEIVE 0x00000008
MEMORY 0x00000010
FILTER 0x00000020
PROTOCOL 0x00000040
REQUEST 0x00000080
UNLOAD 0x00000100
WORK ITEM 0x00000200
OPEN 0x00000400
LOCKS 0x00000800
PLUG AND PLAY 0x00001000
PM 0x00002000
RESET 0x00004000
Windows Machine Instrumentation 0x00008000
CoSTATUS 0x00010000
REFERENCE 0x00020000
ALL 0xFFFFFFFF


All trace output is emitted to the current kernel debugger.


REFERENCES

For additional information about ndistraceimpt, please see the following article in the Microsoft Knowledge Base:

Q182539 HOWTO: Debug NDIS WAN Miniports for MSDUN 1.2x

Additional query words:


Keywords          : kbDebug kbNDIS kbWinOS98 kbx86 kbGrpWin9xDDK 
Version           : WINDOWS:; Win98:
Platform          : WINDOWS Win98 
Issue type        : kbinfo 

Last Reviewed: June 28, 1999