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

RESOLUTION

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

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"/o \storage card"

The complete command line appears as follows:

tux -o -d gdiapi -c"/o \storage card"