Modules Window (Windows Embedded CE 6.0)

1/5/2010

The Modules and Symbols window enables you to load and unload the symbols for a module. The Modules and Symbols window provides different information depending on whether the debugger is running, or if it is at a debug stop or breakpoint.

A symbol is a name that represents a register, an absolute value, or a relative or absolute memory address. Symbols, generated by the compiler, explain the relationship between source code and object code.

Using this dialog box, you can:

• Display information about symbols
• Change symbols
• Unload the symbols
• Use an executable file to reload the symbols.
• Log symbols
• Set Debug Zones
• Choose Docking or Non-Docking mode

When the Debugger Is Running

• Module
  Displays the names of modules running on the target device.

• Image Address Range
  Displays the address range in the memory of the target device where the module is.

• Module Handle
  Handle to the module.

• Usage Mask
  Identifies the number of the process that is using the dll.

• Relocated Data Address Range
  Displays the address range of relocated data.

  If no data was relocated, this field is blank.

• Status
  Displays the status of the module's debugger symbols.

  • Loaded - Debugger has loaded debugger symbols.
  • Unloaded - Debugger has not loaded debugger symbols.

• Timestamp
  Indicates the timestamp of the most recently loaded symbol file.

• Flags
  Flags that indicate an action taken when the module was loaded. The following list shows possible values:

  • DON’T_RESOLVE_DLL_REFERENCES
    Value = 0x1
    If the executable is a DLL, the system did not call DllMain for process and thread initialization. In addition, indicates that the kernel did not load the DLL dependencies.
  • LOAD_LIBRARY_AS_DATAFILE
    Value = 0x2
    DLL was mapped into the virtual address space of the calling process as if it were a data file.
  • LOAD_WITH_ALTERED_SEARCH_PATH
    Value = 0x8
    Not supported.
  • LOAD_LIBRARY_IN_KERNEL
    Value = 0x8000
    DLL was loaded by LoadKernelLibrary.

• Trust Level
  Indicates the trust level of the module.

• PDB Name
  Displays the name of the .pdb file that contains the symbols for the module.

• PDB GUID
  Displays the GUID for the .pdb file.

• PDB Age
  Number of seconds elapsed since PE file produced.

• Symbol Path
  Displays the path where the symbols for the module are stored on the desktop computer.

When the Debugger Is Stopped

The following list describes the columns of information that appear in the Modules window when the debugger is stopped and Command-Line Options with Target Control is running.

• Module
  Displays the name of all modules running on the target device.

• Address
  Displays the load address in the memory of the target device where the module is.

• Module/Process Handle
  Displays the handle for the module or process.

• InUSE
  Displays the In Use status for the module.

  Executable (.exe) files display Not Available.

Context Menu

A context-sensitive shortcut menu appears when you right-click the Module and Symbols window.

Some icons on this menu are also available as toolbar buttons.

This menu contains the following functions:

• Refresh
  Deletes all entries in the window and updates the window to contain the most recent entry information.

• Log
  Formats and copies all data in this window to the Log tab of the Output window.

• Load Symbols
  Loads the debugger symbols for the selected module.

• Unload Symbols
  Unloads the debugger symbols for the selected module.

• Load All Symbols
  Loads the debugger symbols for all modules.

• Unload All Symbols
  Unloads the debugger symbols for all modules.

• List Nearest Symbol
  Select to bring up the List Nearest Symbol Dialog Box.

• Debug Zones
  Opens the Debug Zones Dialog Box.

• List Sources
  Lists the source files for the highlighted module

• List process
  Lists all processes for this module.

See Also

Tasks

Viewing Loaded Symbols

Reference

Debug Windows
Debug Zones Dialog Box