Implementation of the SPI_GETPLATFORMVERSION IOCTL (Windows CE 5.0)

Send Feedback

In Windows CE .NET 4.2 and later, you must implement the SPI_GETPLATFORMVERSION IOCTL in the OAL. SPI_GETPLATFORMVERSION is used in conjunction with the SPI_GETPLATFORMTYPE IOCTL to assign a version number to a run-time image. For more information about SPI_GETPLATFORMTYPE, see SystemParametersInfo.

The version information is necessary because CAB files can now specify that a run-time image only be installed on the target device if the following conditions are true:

  • The run-time image name matches the one in the CAB file.
  • The run-time image version number is in the range specified in the CAB file.

For example, if you are installing a run-time image in Windows CE 5.0, and that run-time image includes the Standard SDK, SPI_GETPLATFORMTYPE must return the following strings to the Wceload tool, Wceload.exe:

const WCHAR HALPlatformStr[] = L"My OEM Platform\0SSDK\0";
const PLATFORMVERSION HALPlatformVer[TOTALPLATFORMS] = {{n, n}, {5, 0}};

Note   The SSDK number must match the OS version number.

The name of your run-time image is always first, followed by SSDK, if you have installed the Standard SDK for Windows CE as part of your run-time image. For more information about the Standard SDK, see Standard SDK for Windows CE.

See Also

OEM Adaptation Layer | OAL Migration | Debugging and Testing

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.