Microsoft KB Archive/823100

= FIX: The CETK graphics device interface (GDI) test does not save an image of a failure =

Article ID: 823100

Article Last Modified on 5/27/2005

-

APPLIES TO


 * Microsoft Windows CE .NET 4.2

-





SYMPTOMS
Although the Microsoft Windows CE Test Kit (CETK) graphics device interface (GDI) test may report a failure, the CETK does not provide an image when the failure occurs.

If you do not have an image of the screen contents of the device when the failure occurs, the problem may be difficult to describe.



Hotfix information
A supported software update is now available from Microsoft as Windows CE 4.2 Core OS QFE 823100. 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

Prerequisites
This hotfix is supported only when all previously released hotfixes for this product have been installed.

Restart requirement
You do not have to restart your computer after you apply this hotfix.

Hotfix replacement information
This hotfix does not replace any other hotfixes.

File information
The English version of this package has the file attributes (or later) that are listed in the following table.   Date         Time   Version        Size    File name

29-Jul-2003 00:22  4.2.3.728     887,400  Wincepb42-030728-kb823100-armv4.exe 29-Jul-2003 00:22  4.2.3.728     887,400  Wincepb42-030728-kb823100-armv4i.exe 29-Jul-2003 00:22  4.2.3.728     903,784  Wincepb42-030728-kb823100-mipsii.exe 29-Jul-2003 00:22  4.2.3.728     903,784  Wincepb42-030728-kb823100-mipsii_fp.exe 29-Jul-2003 00:22  4.2.3.728     903,784  Wincepb42-030728-kb823100-mipsiv.exe 29-Jul-2003 00:22  4.2.3.728     903,784  Wincepb42-030728-kb823100-mipsiv_fp.exe 29-Jul-2003 00:22  4.2.3.728     883,304  Wincepb42-030728-kb823100-sh3.exe 29-Jul-2003 00:22  4.2.3.728     887,400  Wincepb42-030728-kb823100-sh4.exe 29-Jul-2003 00:22  4.2.3.728     866,920  Wincepb42-030728-kb823100-x86.exe The English version of this hotfix has the file attributes (or later) 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 tool in Control Panel.   Date         Time                      Size    File name --

Path: Pb\Cepb\Wcetk\Ddtk\Armv4 09-Jul-2003 06:04                    433,664  Gdiapi.dll       ARM 09-Jul-2003 06:04                    733,184  Gdiapi.pdb

Path: Pb\Cepb\Wcetk\Ddtk\Armv4i 09-Jul-2003 08:08                    436,224  Gdiapi.dll 09-Jul-2003 08:08                    733,184  Gdiapi.pdb

Path: Pb\Cepb\Wcetk\Ddtk\Mipsii 09-Jul-2003 10:14                    500,224  Gdiapi.dll       R4000 09-Jul-2003 10:14                    757,760  Gdiapi.pdb

Path: Pb\Cepb\Wcetk\Ddtk\Mipsii_fp 09-Jul-2003 12:21                    499,712  Gdiapi.dll 09-Jul-2003 12:21                    749,568  Gdiapi.pdb

Path: Pb\Cepb\Wcetk\Ddtk\Mipsiv 09-Jul-2003 18:49                    503,808  Gdiapi.dll 09-Jul-2003 18:49                    757,760  Gdiapi.pdb

Path: Pb\Cepb\Wcetk\Ddtk\Mipsiv_fp 09-Jul-2003 21:14                    500,224  Gdiapi.dll       MIPSFPU 09-Jul-2003 21:14                    757,760  Gdiapi.pdb

Path: Pb\Cepb\Wcetk\Ddtk\Sh3 09-Jul-2003 14:30                    406,528  Gdiapi.dll 09-Jul-2003 14:30                    741,376  Gdiapi.pdb

Path: Pb\Cepb\Wcetk\Ddtk\Sh4 09-Jul-2003 16:40                    406,016  Gdiapi.dll 09-Jul-2003 16:40                    733,184  Gdiapi.pdb

Path: Pb\Cepb\Wcetk\Ddtk\X86 09-Jul-2003 03:48                    380,928  Gdiapi.dll 09-Jul-2003 03:48                    716,800  Gdiapi.pdb



STATUS
Microsoft has confirmed that this is a problem in the Microsoft products that are listed in the &quot;Applies to&quot; section.



MORE INFORMATION
This update improves the CETK GDI test so that you can save a bitmap image when the device fails a test. The GDI test tool, GDIAPI, can create a bitmap image of the device display screen when the device fails a test. For example, the device may fail the CheckScreenHalves test or the Driver verification test.

By default, when bitmap image creation is turned on, the bitmap image is stored in the release directory. The bitmap image is stored by using kernel independent transport layer (KITL). If the user is testing a device that does not have a KITL connection to Microsoft Windows CE Platform Builder, the user may specify a location that is accessible to the device. For example, the user may specify a storage card that is attached to the device or that is attached to a writable network share. Bitmap images may be saved to any location where the device has write access.

You can enable bitmap image creation as follows:
 * To enable bitmap image creation in the release directory, pass the /o parameter to the test DLL.
 * To enable bitmap image creation in a user-specified location, pass the /o parameter to the test DLL, followed by the path where you want to store the bitmap image.

Important Before you test the device, make sure that the location where you want to save the bitmap image is a valid location.

To pass the parameter from the tux command line to the test DLL, use the tux -c option, and enclose the whole /o option in quotation marks. For example, to save the test failure bitmap images to a Compact Flash card, append the following command to the existing command line as it appears in the CETK:

 -c&quot;/o \storage card&quot; 

The complete command line appears as follows:

tux -o -d gdiapi -c&quot;/o \storage card&quot;

Keywords: kbbug kbfix kbqfe KB823100

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.