CEDevice

The [CEDevice] section is optional and describes the platform for which your application is targeted. All keys in this section are optional. If a key is nonexistent, Microsoft® Windows® CE does not perform the checks specified for that particular key. Windows CE also does not perform any checking if a key has no data. The exception is UnsupportedPlatforms; if this key exists but there is no data, the previous value is not overridden.

[CEDevice]
[ProcessorType =[processor_type]]
[UnsupportedPlatforms = platform_family_name[,platform_family_name]]
[VersionMin = [major_version.minor_version]]
[VersionMax = [major_version.minor_version]]

Parameters

• processor_type
  Value that is returned by SYSTEM_INFO.dwProcessorType.

• platform_family_name
  A list of platform family names that are known to be unsupported.

  If the platform_family_name specified in the [CEDevice.xxx] section is different from that in the [CEDevice] section, both platform_family_name values are unsupported for the microprocessor that is specified by xxx. The list of specific unsupported platform family names is appended to the previous list of unsupported platform family names.

  Application Manager will not display the application for an unsupported platform. Also, a user will be warned during the setup process if the .cab file is copied to an unsupported device.

  In the following code example, the [CEDevice] section, which is not platform-specific, sets UnsupportedPlatforms to pltfrm1, while [CEDevice.SH3] merely appends its own list of unsupported platforms.

  [CEDevice]
  UnsupportedPlatforms = pltfrm1
  [CEDevice.SH3]
  UnsupportedPlatforms =
  

• major_version and minor_version
  Numeric values that are returned by OSVERSIONINFO.dwVersionMinor and OSVERSIONINFO.dwVersionMajor. The .cab file is valid for the currently connected device if the version of the currently connected device is less than or equal to VersionMax and also greater than or equal to VersionMin.

  For Windows CE 2.0 -based Japanese-language devices, set VersionMin and VersionMax to 2.01.

If you are using Microsoft® ActiveSync® 3.0 or later, use the VersionMin and VersionMax keys to distinguish between black and white and color displays on a Palm-size PC. The following table describes how to declare VersionMin and VersionMax to distinguish between the different displays.

The following code example shows how to use one .inf file to distinguish between different Palm-size PC hardware capabilities.

[CEDevice.PPC_1]; black&white Palm-size PC 1.0
VersionMin = 2.1
VersionMax = 2.1
UnsupportedPlatforms = "HPC","HPC Pro"

[CEDevice.PPC_2]; color Palm-size PC 2.0
VersionMin = 2.11
VersionMax = 2.11
UnsupportedPlatforms = "HPC","HPC Pro"

[CEDevice.PPC_3]; color Palm-size PC 3.0 and above
VersionMin = 3.0
VersionMax = 1000.0; an arbitrary high value
UnsupportedPlatforms = "HPC","HPC Pro"

The following code example shows three [CEDevice] sections. One gives basic information for any CPU. The next two are specific to the SH3 and the MIPS microprocessors, and create .cab files that are only valid for the given microprocessor.

Note   To create the two CPU-specific .cab files for the setup .inf file in this code example, you must run the CAB Wizard with the /cpu sh3 mips parameter.

The following section specifies version 2.0 devices only, using VersionMin and VersionMax.

[CEDevice]
UnsupportedPlatforms = pltfrm1
VersionMin = 2.0
VersionMax = 2.0

The following section inherits all [CEDevice] settings, but overrides the version settings so that no version checking is performed.

[CEDevice.SH3]
ProcessorType = 10003
UnsupportedPlatforms =
VersionMin =
VersionMax =

The following section inherits all [CEDevice] settings, and appends pltfrm2 to UnsupportedPlatforms so that pltfrm1 and pltfrm2 are not supported for the "MIPs" .cab file.

[CEDevice.MIPS]
ProcessorType = 4000
UnsupportedPlatforms =pltfrm2

See Also

SYSTEM_INFO | Creating an .inf File | CAB Wizard Overview | CAB Wizard Syntax

 Last updated on Friday, October 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.