Error Reporting Catalog Items and Sysgen Variables (Compact 2013)

3/26/2014

In Windows Embedded Compact, you can implement functionality for generating error reports on a Windows Embedded Compact powered device and uploading them to the Microsoft Watson web site.

For more information, see Error Reporting Reference.

For more information about how to add or remove catalog items, see Create Your First OS.

Hardware and Software Requirements

  • Requires at least 128 KB in reserved memory to support generated dump files, and must be a multiple of the device PAGE_SIZE. For more information, see Error Reporting Dump Files.

Catalog Items and Sysgen Variables

The following table describes the catalog items and associated SYSGEN variables you can use to add error reporting functionality to your OS.

Catalog Item

SYSGEN Variable

Description

Dependencies

Error Report Generator (kdmp) support

SYSGEN_WATSON_DMPGEN

Generates an on-device error report (.kdmp) upon a second-chance exception. This report is useful for post-mortem debugging.

Requires SYSGEN_WATSON_XFER and SYSGEN_WATSON_CLIENT.

If the device uses a flash device to persist storage, the OEM must implement the related drivers.

Error Report Transfer Driver

SYSGEN_WATSON_XFER

Generates the transfer driver to move error reports from reserved memory to the file system. Sets registry values needed by the Error Report Generator.

  • Requires a file system, and the device driver API.

Report Upload Client

SYSGEN_WATSON_CLIENT

Uploads error reports to the Watson web site.

  • Requires SYSGEN_WATSON_DMPGEN and SYSGEN_WATSON_XFER.
  • For clients that upload error reports over an Ethernet connection, requires SYSGEN_NETWORKING.

Report Upload Client UI

SYSGEN_WATSON_CLIENT_UI

Provides a user interface for error report upload.

Requires SYSGEN_WATSON_CLIENT. Requires a device with a user interface.

Sysgen Variables

The following table describes the SYSGEN variable for the Report Upload Client.

SYSGEN variable

Description

SYSGEN_REPLACE_DWCONN

Enables replacement of the connection management code provided by DwConn.lib.

See Also

Other Resources

Error Reporting