Small Windows Mobile/CE application for debug or test purpose

When I was a beginner in Windows Mobile programming, even for a small test I used to create a single MFC dialog-based application with one button, and put my test code in the OnLButtonDown method.

For Pocket PC it worked fine, on some Windows CE device that, sometimes, didn’t have the MFC DLLs, this application even didn’t start. For the first Microsoft Smartphones I needed to use another wizard, another resource file, special control compilation definitions, and so, many configurations.

Now I know that it is unbelievably easy to make a small application without any GUI or just with a message box that can be compiled for any Microsoft Mobile or CE platform and simply works. It allows me to be concentrated on the research or testing task and do not waste time on GUI arrangements, and project configurations compilation definitions, precompiled headers and other wizard generated stuff.

Here are the steps to create this smallest Windows Mobile/CE application:

1. In Visual Studio, in the File menu choose “New” and then “Project…”

2. In the wizard, in Visual C++ section choose “Smart Device” item and on this page choose “Win32 Smart Device Project”.

3. Set the solution name and press “Ok”.
4. You see the standard wizard for the Smart Device project. Don’t click on “Finish” - we need to change few default options.

5. Choose Platforms and add platforms you need. I always add Windows Mobile 5 and 6 and even “old-fashion” Smartphone 2003. Press “Next” to go to the “Application Settings” page.

6. Check “Empty project” checkbox and now press “Finish”.


7. We have the solution and the project, but there are no source code files. To make one, I’m adding “New Item…” to the Source Files – choose “Add” in the popup menu and “New Items…” in the next popup.

8. Be sure that you have “Code” item selected in the “Visual C++” tree and “C++ File (.cpp)” in the Templates page. Set name for the cpp-file (for example, main) and press “Add” button.

9. Empty source file added. We need to add few lines of code.

10. Let’s add the following source code:

#define WINVER _WIN32_WCE

#include <windows.h>

HINSTANCE    g_hInstance = NULL;

int WINAPI WinMain(HINSTANCE hInstance,
HINSTANCE hPrevInstance,
LPWSTR    lpCmdLine,
int       nCmdShow)

{
UNREFERENCED_PARAMETER(hPrevInstance);
UNREFERENCED_PARAMETER(lpCmdLine);
UNREFERENCED_PARAMETER(nCmdShow);

// store the hInstance in global
g_hInstance = hInstance;

return 0;
}

The code is trivial – the standard main function that does nothing, windows.h file included, and one define set WINVER _WIN32_WCE.
You can compile this code, launch the executable on your device or in emulator – the application does nothing and shows nothing. It is just a wrapper (or template) for your future test applications.
Note: if you use Pocket PC 2003, you need to make one change in the project settings.

It is “Buffer Security Check” on “Code Generation” page in C/C++ section. The value of this field should be “No (/GS-)”
For example this program will show the memory usage:

#define WINVER _WIN32_WCE

#include <windows.h>

HINSTANCE    g_hInstance = NULL;

int WINAPI WinMain(HINSTANCE hInstance,
HINSTANCE hPrevInstance,
LPWSTR    lpCmdLine,
int       nCmdShow)

{
UNREFERENCED_PARAMETER(hPrevInstance);
UNREFERENCED_PARAMETER(lpCmdLine);
UNREFERENCED_PARAMETER(nCmdShow);

// store the hInstance in global
g_hInstance = hInstance;

MEMORYSTATUS mem_status = { 0 };
GlobalMemoryStatus(&mem_status);

WCHAR szText[MAX_PATH] = { 0 };
_snwprintf(szText, MAX_PATH, L"Memory use: %d%", mem_status.dwMemoryLoad);

::MessageBox(NULL, szText, L"Test", MB_OK);

return 0;
}

If you have a simple tracer, for example, as the one below:

#ifndef _TRACER_HEADER_
#define _TRACER_HEADER_

#include <stdlib.h>
#include <wchar.h>

inline void __cdecl Tracer(LPCWSTR lpszFormat, ...)
{
va_list args;
va_start(args, lpszFormat);

int nBuf = 0;
WCHAR szBuffer[1024];
ZeroMemory(szBuffer, 1024 * sizeof(WCHAR));
nBuf = _vsnwprintf(szBuffer + nBuf, 1024, lpszFormat, args);

static HANDLE hFile = INVALID_HANDLE_VALUE;
if (hFile == INVALID_HANDLE_VALUE) 
{

WCHAR szFileName[MAX_PATH];
ZeroMemory(szFileName, MAX_PATH * sizeof(WCHAR));
::GetModuleFileName(GetModuleHandle(NULL), szFileName, MAX_PATH);
int nLength = lstrlen(szFileName);
while (nLength > 0){
nLength--;
if(szFileName[nLength] == TCHAR('.'))
break;
}
szFileName[nLength + 1] = 0;
wcsncat(szFileName, L"txt", MAX_PATH - 2);
hFile = ::CreateFileW(szFileName, GENERIC_WRITE | GENERIC_READ,
FILE_SHARE_READ, NULL, CREATE_ALWAYS, 0, NULL);
if (hFile != INVALID_HANDLE_VALUE) {

DWORD nErr = GetLastError();
DWORD nWritten = 0;

SetFilePointer(hFile, 0, 0, FILE_END);

if (nErr != ERROR_ALREADY_EXISTS)
{
char szHeader[2] = { (char)0xFF, (char)0xFE };
::WriteFile(hFile, szHeader, 2, &nWritten, NULL);
}

::WriteFile(hFile, L" ", 5 * sizeof(WCHAR), &nWritten, NULL);
WCHAR sz[2] = { WCHAR(13), WCHAR(10) };
::WriteFile(hFile, sz, 4, &nWritten, NULL);
}
}


if (hFile != INVALID_HANDLE_VALUE) 
{
DWORD nLength = wcslen(szBuffer) * sizeof(WCHAR);
DWORD nWritten = 0;
::WriteFile(hFile, szBuffer, nLength, &nWritten, NULL);
WCHAR sz[2] = { WCHAR(13), WCHAR(10) };
::WriteFile(hFile, sz, 4, &nWritten, NULL);
FlushFileBuffers(hFile);
}
va_end(args);
}


#endif

you can use it instead of the message box. For example, the following code will detect how many memory you can allocate on your device with function malloc():

#define WINVER _WIN32_WCE

#include <windows.h>
#include "tracer.h"

HINSTANCE    g_hInstance = NULL;

int WINAPI WinMain(HINSTANCE hInstance,
HINSTANCE hPrevInstance,
LPWSTR    lpCmdLine,
int       nCmdShow)

{
UNREFERENCED_PARAMETER(hPrevInstance);
UNREFERENCED_PARAMETER(lpCmdLine);
UNREFERENCED_PARAMETER(nCmdShow);

// store the hInstance in global
g_hInstance = hInstance;

MEMORYSTATUS mem_status = { 0 };
GlobalMemoryStatus(&mem_status);
Tracer(L"Total physical memory %d\n", mem_status.dwTotalPhys);
Tracer(L"Memory usage %d\n", mem_status.dwMemoryLoad);

LPVOID p = NULL;
DWORD nDelta = 1024 * 1024;
DWORD nSize = 0;
do 
{
if (p != NULL)
{
free(p);
p = NULL;
}
nSize += nDelta;
p = malloc(nSize);
if (p != NULL)
Tracer(L"p= %p, %d bytes allocated\n", p, nSize);
} while(p != NULL);

if (p != NULL)
{
free(p);
p = NULL;
}

return 0;
}

The log-file made on the Windows Mobile 6 Classic emulator will show that you can allocate almost 30MB. HTC Diamond allowed for such small application to allocate 26,214,400 bytes. Please do not test this code under Windows CE 6.0 – the memory management changed in this version and this code may cause a problem.
In EE: "Small Windows Mobile/CE application for debug or test purpose"