A memory usage monitoring tool that uses the Toolhelp APIs to monitor an application may not work correctly on a Windows Embedded CE 6.0 R2-based device or on a Windows Embedded CE 6.0 R3-based device

Article translations Article translations
Article ID: 2249451 - View products that this article applies to.
Expand all | Collapse all

SYMPTOMS

You use a memory usage monitoring tool that uses the Toolhelp APIs to monitor an application on a Windows Embedded CE 6.0 R2-based device or on a Windows Embedded CE 6.0 R3-based device. When the system has too many heaps or when the system has large heaps, the tool may not work correctly.

For example, you use the DevHealth60.exe utility to report the memory information about the application. When there are lots of memory heaps, the utility may not work correctly.

CAUSE

This issue occurs because the system requires more than 4 megabytes (MB) to store the heap information. However, the maximum buffer size of the Toolhelp snapshot is 4 MB. This behavior causes some heap data to be excluded from the Toohelp snapshot. Therefore, you experience the issue that is described in the Symptoms section.

RESOLUTION

Software update information

A supported software update is now available from Microsoft as Windows Embedded CE 6.0 Platform Builder Monthly Update (June 2010). You can confirm this by scrolling to the "File information" section of this article. The package file name contains the product version, date, Knowledge Base article number, and processor type. The package file name format is:
Product version-yymmdd-kbnnnnnn-processor type
For example: Wincepb50-060503-kb917590-armv4i.msi is the ARMV4i Windows CE 5.0 Platform Builder fix that is documented in KB article 917590 and that is contained in the May 2006 monthly update. To resolve this problem immediately, click the following article number for information about obtaining Windows CE Platform Builder and core operating system software updates:
837392 How to locate core operating system fixes for Microsoft Windows CE Platform Builder products


This update adds a registry entry that specifies the size of the Toolhelp snapshot buffer.

After you install the update, you can add the following information to the Project.reg file to specify the buffer size: [HKEY_LOCAL_MACHINE\KERNEL\TOOLHELP]
"THSnapReserve"=dword:0x00400000


Note The THSnapReserve registry entry is defined in bytes and the range is between 4MB and 128 MB. The default value of the registry key is 4MB. The registry key value is read by the operating system only during the startup process.

Prerequisites

This update is supported only if all previously issued updates for this product have also been installed.

Restart requirement

After you apply this update, you must perform a clean build of the whole platform. To do this, use one of the following methods:
  • On the Build menu, click Clean, and then click Build Platform.
  • On the Build menu, click Rebuild Platform.
You do not have to restart the computer after you apply this software update.

Update replacement information

This update does not replace any other updates.

File information

The English version of this software update package has the file attributes (or later file attributes) that are listed in the following table. The dates and times for these files are listed in Coordinated Universal Time (UTC). When you view the file information, it is converted to local time. To find the difference between UTC and local time, use the Time Zone tab in the Date and Time item in Control Panel.
Installer files
Collapse this tableExpand this table
File nameFile sizeDateTime
Wincepb60-100629-kb2249451-armv4i.msi3,757,05629-Jun-201022:11
Wincepb60-100629-kb2249451-mipsii.msi3,595,26429-Jun-201022:11
Wincepb60-100629-kb2249451-mipsii_fp.msi3,702,78429-Jun-201022:11
Wincepb60-100629-kb2249451-mipsiv.msi3,641,85629-Jun-201022:11
Wincepb60-100629-kb2249451-mipsiv_fp.msi3,751,93629-Jun-201022:11
Wincepb60-100629-kb2249451-sh4.msi3,392,51229-Jun-201022:11
Wincepb60-100629-kb2249451-x86.msi3,207,68029-Jun-201022:11
Files that are included in this hotfix package
Collapse this tableExpand this table
File nameFile sizeDateTimePath
Windows embedded ce 6.0_update_kb2249451.htm8,60629-Jun-201022:24100629_kb2249451
Lmem.lib233,01214-Jun-201018:50Public\Common\Oak\Lib\Armv4i\Debug
Lmemhs.lib277,35414-Jun-201018:50Public\Common\Oak\Lib\Armv4i\Debug
Nkmain.lib2,725,43614-Jun-201018:50Public\Common\Oak\Lib\Armv4i\Debug
Nkprmain.lib2,762,32414-Jun-201018:50Public\Common\Oak\Lib\Armv4i\Debug
Lmem.lib122,48614-Jun-201018:50Public\Common\Oak\Lib\Armv4i\Retail
Lmemhs.lib158,06814-Jun-201018:50Public\Common\Oak\Lib\Armv4i\Retail
Nkmain.lib1,758,29414-Jun-201018:49Public\Common\Oak\Lib\Armv4i\Retail
Nkprmain.lib1,783,78014-Jun-201018:49Public\Common\Oak\Lib\Armv4i\Retail
Lmem.lib220,77614-Jun-201018:51Public\Common\Oak\Lib\Mipsii\Debug
Lmemhs.lib263,80014-Jun-201018:51Public\Common\Oak\Lib\Mipsii\Debug
Nkmain.lib2,583,38814-Jun-201018:51Public\Common\Oak\Lib\Mipsii\Debug
Nkprmain.lib2,619,37014-Jun-201018:51Public\Common\Oak\Lib\Mipsii\Debug
Lmem.lib115,85614-Jun-201018:51Public\Common\Oak\Lib\Mipsii\Retail
Lmemhs.lib152,18614-Jun-201018:51Public\Common\Oak\Lib\Mipsii\Retail
Nkmain.lib1,672,25814-Jun-201018:51Public\Common\Oak\Lib\Mipsii\Retail
Nkprmain.lib1,702,41414-Jun-201018:51Public\Common\Oak\Lib\Mipsii\Retail
Lmem.lib220,83214-Jun-201018:53Public\Common\Oak\Lib\Mipsii_fp\Debug
Lmemhs.lib263,82414-Jun-201018:53Public\Common\Oak\Lib\Mipsii_fp\Debug
Nkmain.lib2,658,22214-Jun-201018:53Public\Common\Oak\Lib\Mipsii_fp\Debug
Nkprmain.lib2,694,48014-Jun-201018:53Public\Common\Oak\Lib\Mipsii_fp\Debug
Lmem.lib115,90614-Jun-201018:53Public\Common\Oak\Lib\Mipsii_fp\Retail
Lmemhs.lib152,23614-Jun-201018:53Public\Common\Oak\Lib\Mipsii_fp\Retail
Nkmain.lib1,731,93614-Jun-201018:52Public\Common\Oak\Lib\Mipsii_fp\Retail
Nkprmain.lib1,762,19614-Jun-201018:52Public\Common\Oak\Lib\Mipsii_fp\Retail
Lmem.lib224,40014-Jun-201018:54Public\Common\Oak\Lib\Mipsiv\Debug
Lmemhs.lib268,86414-Jun-201018:54Public\Common\Oak\Lib\Mipsiv\Debug
Nkmain.lib2,615,71814-Jun-201018:54Public\Common\Oak\Lib\Mipsiv\Debug
Nkprmain.lib2,651,83414-Jun-201018:54Public\Common\Oak\Lib\Mipsiv\Debug
Lmem.lib118,70614-Jun-201018:54Public\Common\Oak\Lib\Mipsiv\Retail
Lmemhs.lib157,01414-Jun-201018:54Public\Common\Oak\Lib\Mipsiv\Retail
Nkmain.lib1,697,40814-Jun-201018:53Public\Common\Oak\Lib\Mipsiv\Retail
Nkprmain.lib1,727,46814-Jun-201018:53Public\Common\Oak\Lib\Mipsiv\Retail
Lmem.lib224,45614-Jun-201018:55Public\Common\Oak\Lib\Mipsiv_fp\Debug
Lmemhs.lib268,88814-Jun-201018:55Public\Common\Oak\Lib\Mipsiv_fp\Debug
Nkmain.lib2,695,80614-Jun-201018:55Public\Common\Oak\Lib\Mipsiv_fp\Debug
Nkprmain.lib2,732,19814-Jun-201018:55Public\Common\Oak\Lib\Mipsiv_fp\Debug
Lmem.lib118,75614-Jun-201018:55Public\Common\Oak\Lib\Mipsiv_fp\Retail
Lmemhs.lib157,06414-Jun-201018:55Public\Common\Oak\Lib\Mipsiv_fp\Retail
Nkmain.lib1,763,55014-Jun-201018:55Public\Common\Oak\Lib\Mipsiv_fp\Retail
Nkprmain.lib1,793,71014-Jun-201018:55Public\Common\Oak\Lib\Mipsiv_fp\Retail
Lmem.lib190,59214-Jun-201018:56Public\Common\Oak\Lib\Sh4\Debug
Lmemhs.lib228,63814-Jun-201018:56Public\Common\Oak\Lib\Sh4\Debug
Nkmain.lib2,178,63414-Jun-201018:56Public\Common\Oak\Lib\Sh4\Debug
Nkprmain.lib2,203,89414-Jun-201018:56Public\Common\Oak\Lib\Sh4\Debug
Lmem.lib105,75414-Jun-201018:56Public\Common\Oak\Lib\Sh4\Retail
Lmemhs.lib138,45014-Jun-201018:56Public\Common\Oak\Lib\Sh4\Retail
Nkmain.lib1,515,94214-Jun-201018:56Public\Common\Oak\Lib\Sh4\Retail
Nkprmain.lib1,540,36614-Jun-201018:56Public\Common\Oak\Lib\Sh4\Retail
Lmem.lib188,55614-Jun-201018:49Public\Common\Oak\Lib\X86\Debug
Lmemhs.lib226,37414-Jun-201018:49Public\Common\Oak\Lib\X86\Debug
Nkmain.lib2,170,41014-Jun-201018:49Public\Common\Oak\Lib\X86\Debug
Nkprmain.lib2,198,56814-Jun-201018:49Public\Common\Oak\Lib\X86\Debug
Lmem.lib106,86614-Jun-201018:49Public\Common\Oak\Lib\X86\Retail
Lmemhs.lib138,33814-Jun-201018:49Public\Common\Oak\Lib\X86\Retail
Nkmain.lib1,527,85214-Jun-201018:48Public\Common\Oak\Lib\X86\Retail
Nkprmain.lib1,547,89414-Jun-201018:48Public\Common\Oak\Lib\X86\Retail

STATUS

Microsoft has confirmed that this is a problem in the Microsoft products that are listed in the "Applies to" section.

MORE INFORMATION

For more information about the Toolhelp APIs, visit the following Microsoft Developer Network (MSDN) website:
General information about the Toolhelp APIs
For more information about the DevHealth60.exe utility, visit the following MSDN website:
General information about the DevHealth60.exe utility
For more information about software update terminology, click the following article number to view the article in the Microsoft Knowledge Base:
824684 Description of the standard terminology that is used to describe Microsoft software updates

Properties

Article ID: 2249451 - Last Review: September 1, 2010 - Revision: 3.0
APPLIES TO
  • Windows Embedded CE 6.0 R2
  • Windows Embedded CE 6.0 R3
Keywords: 
kbqfe kbfix kbexpertiseadvanced kbsurveynew KB2249451

Give Feedback

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com