CallEdbgRegisterClient (Windows CE 5.0)

Send Feedback

This function registers a KITL client.

BOOL CallEdbgRegisterClient(UCHAR* pId,char* ServiceName,UCHARFlags,UCHARWindowSize,UCHAR* pBufferPool);

Parameters

  • pId
    [out] Pointer to a UCHAR variable that receives the KITL client identifier.

  • ServiceName
    [in] Pointer to the name of the string that contains the name of the service that is being registered. The string should be null terminated and should be up to MAX_SVCNAME_LEN characters.

  • Flags
    [in] Specifies the action to take. The flags are defined in %_WINCEROOT%\Public\Common\Oak\Inc\Kitlprot.h.

    The following table shows possible flags for this parameter.

    Flag Description
    KITL_CFGFL_STOP_AND_WAIT Stop after each transmission and wait for an acknowledgement.
    KITL_CFGFL_NOACKS Do not acknowledge data messages.
    KITL_CFGFL_MULTIINST Allow multiple instances of this service on the device.
  • WindowSize
    [in] Protocol window size up to KITL_MAX_WINDOW_SIZE.

    The default value is 8.

  • pBufferPool
    [in] Pointer to a buffer pool to use for KITL packet buffers.

    The size of the buffer pool must be equal to WindowSize*2* KITL_MTU.

Return Values

Returns TRUE if the call was successful; otherwise, returns FALSE.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Halether.h.
Link Library: Hal.lib.

See Also

CallEdbgDeregisterClient

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.