Share via


NDIS Debug (Windows Embedded CE 6.0)

1/6/2010

Windows Embedded CE operating system (OS) debug zones control NDIS debug output through debug zones. You can enable different levels of debug in various NDIS components through the registry. Adding the following entries and values to the HKEY_LOCAL_MACHINE\Comm\NDIS\Parms registry key enables levels of debug.

"DebugLevel"=dword:00000000
"DebugSystems"=dword:000030F3
"DebugBreakPoint"=dword:00000001 

The following list indicates acceptable values to set for DebugBreakPoint, DebugLevel and DebugSystems:

  • DebugBreakPoint
    Setting to 1 causes NDIS to debug break in its DriverEntry function.

  • DebugLevel
    Selects the level or amount of debug tracing in NDIS components designated with the DebugSystems value.
    The following table shows the values that specify levels you can select.

    Level description Value

    DBG_LEVEL_INFO

    0x00000000

    DBG_LEVEL_LOG

    0x00000800

    DBG_LEVEL_WARN

    0x00001000

    DBG_LEVEL_ERR

    0x00002000

    DBG_LEVEL_FATAL

    0x00003000

  • DebugSystems
    Selects various NDIS components to debug trace.
    The following table shows the values that specify the NDIS components you can select.

    Component description Value

    DBG_COMP_INIT

    0x00000001

    DBG_COMP_CONFIG

    0x00000002

    DBG_COMP_SEND

    0x00000004

    DBG_COMP_RECV

    0x00000008

    DBG_COMP_PROTOCOL

    0x00000010

    DBG_COMP_BIND

    0x00000020

    DBG_COMP_BUSINFO

    0x00000040

    DBG_COMP_REG

    0x00000080

    DBG_COMP_MEMORY

    0x00000100

    DBG_COMP_FILTER

    0x00000200

    DBG_COMP_REQUEST

    0x00000400

    DBG_COMP_WORK_ITEM

    0x00000800

    DBG_COMP_PNP

    0x00001000

    DBG_COMP_PM

    0x00002000

    DBG_COMP_OPENREF

    0x00004000

    DBG_COMP_LOCKS

    0x00008000

    DBG_COMP_RESET

    0x00010000

    DBG_COMP_WMI

    0x00020000

    DBG_COMP_CO

    0x00040000

    DBG_COMP_REF

    0x00080000

    DBG_COMP_ALL

    0xFFFFFFFF

You can select more than one NDIS component. If more than one component is selected, OR the data values together. For example, to select PNP, PM, INIT and CONFIG.

"DebugSystems"=dword:00003003

Note

Using the registry technique to enable debug tracing is a good idea if the symbols directory of the host computer does not contain the checked symbols of Ndis.sys. However, whenever you change settings for debug tracing, you must restart your computer for the new settings to take effect.

See Also

Concepts

Network Driver Programming Considerations