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.