Share via


IOCTL_EDBG_REGISTER_CLIENT (Windows Embedded CE 6.0)

1/5/2010

This I/O control registers a KITL client and activates passive KITL clients.

Parameters

  • dwIoControlCode
    [in] Set to IOCTL_EDBG_REGISTER_CLIENT.
  • pId
    [out] Pointer to a UCHAR that receives the KITL client identifier.
  • 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_MULTIINST

    Allow multiple instances of this service on the device.

  • ServiceName
    [in] Pointer to 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.
  • 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

TRUE indicates success. FALSE indicates failure.

Remarks

The kernel has been enhanced to automatically register default KITL clients. Previously this I/O control enabled the user to perform this action. Moving forward your code does not need to handle the registration of default KITL clients. However, this control remains so you can register custom clients. If your BSP doesn't handle custom KITL clients it can be freed of code using this control.

See Also

Reference

EDBG IOCTLs
KITL IOCTLs