How to configure KITL to operate in passive mode in Windows CE .NET 4.2 and Windows CE 5.0 (823606)

SUMMARY

In Microsoft Windows CE .NET 4.2 and Windows CE 5.0, you can configure the Kernel Independent Transport Layer (KITL) to operate in passive mode. This can be useful in situations where you intend to use the device without the desktop tools, but where you may occasionally need a debug connection. In passive mode, the connection to the desktop tools is not established until KITL is enabled. KITL will be enabled when a KITL client is registered.

MORE INFORMATION

The following code example shows how to register a KITL client:

#include <windows.h>
#include <halether.h>

int WINAPI WinMain (
                HINSTANCE hInst,
                HINSTANCE hInstPrev, 
                LPTSTR pszCmdLine, 
                int nCmdShow)
{
    PUCHAR pBufferPool = (PUCHAR)malloc(64*1024);
    UCHAR ClientId;

    if (CallEdbgRegisterClient(&ClientId, "KTC", 0, 8, pBufferPool) == FALSE)
        RETAILMSG(1, (TEXT("KITLRegisterClient failed.\r\n")));
    else
        RETAILMSG(1, (TEXT("KITLRegisterClient succeeded.\r\n")));

    while(1)
        /* do nothing */;

    return 0;
}

Note This code assumes that the Windows CE platform has been configured for passive KITL. The method to configure KITL to operate in passive mode varies from platform to platform.