Share via


OS Design Property Pages: Build Options

Other versions of this page are also available for the following:

Windows Mobile Not SupportedWindows Embedded CE Supported

8/27/2008

This category enables you to choose the build options that you want to set for the active OS design. For more information about the dialog box, see OS Design Property Pages Dialog Box, and the Visual Studio documentation.

  • Buffer tracked events in RAM (IMGOSCAPTURE=1)
    Select to buffer events tracked by OSCapture.exe in RAM.
  • Enable Eboot Space in Memory (IMGEBOOT=1)
    Select to reserve memory space in the Config.bib file. This allows the boot loader to save data that the OS can read at boot time.
  • Enable Event Tracking during Boot (IMGCELOGENABLE=1)
    Select to start the event-tracking subsystem.
  • Enable hardware-assisted debugging support (IMGHDSTUB=1)
    Select to support hardware-assisted debugging. This variable is automatically enabled if you define the Watson sysgen variables to support Windows Error Reporting.
  • Enable Kernel Debugger (no IMGNODEBUGGER=1)
    Select before building the run-time image to allow the debugger to connect and pass debugging information from the target device to the host device. When Enable Kernel Debugger is selected, IMGNODEBUGGER is 0. When cleared, IMGNODEBUGGER is 1.
  • Enable KITL (no IMGNOKITL=1)
    Select to enable KITL and to allow communication between the development workstation and the target device.
  • Enable Profiling (IMGPROFILER=1)
    Select to enable Windows Embedded CE log kernel profiling in the run-time image. This is the same as setting the IMGPROFILER or IMGCELOGENABLE environment variables to 1.

    Do not add the profiler to shipping devices. The goal is to avoid performance and memory loss due to the profiler.

  • Enable Ship Build (WINCESHIP=1)
    Select to set the environment variable WINCESHIP to 1, which defines the compile time flag -DSHIP_BUILD. This flag can be used to conditionally compile code. If set, the OS does not output debug messages. If not set, the OS provides verbose debug messages to aid debugging. This check box is displayed only in a release configuration, and is hidden in debug configurations.
  • Flush tracked events to Release Directory (IMGAUTOFLUSH=1)
    Select to flush events to the release directory. Selecting this also turns on event tracking.
  • Run-time Image Can be Larger than 32 MB (IMGRAM64=1)
    Select to enable a run-time image that requires 32 MB or more of RAM in order to successfully download to the target device after the run-time image is built.
  • Use XCOPY instead of links to populate release directory (BUILDREL_USE_COPY=1)
    Select to directly copy files to the release directory.
  • Write Run-time Image to Flash Memory (IMGFLASH=1)
    Select to allow the run-time image to be written to flash memory after download.

See Also

Reference

OS Design Property Pages Dialog Box

Concepts

Context-Sensitive Help (Visual Studio)

Other Resources

IMG Environment Variables