IOCTL_EDBG_DEREGISTER_CLIENT (Compact 2013)

10/16/2014

This I/O control message deregisters a KITL client. Send this message with KernelIoControl.

Syntax

BOOL KernelIoControl(
    DWORD dwIoControlCode,
    LPVOID lpInBuffer,
    DWORD pId,
    LPVOID lpOutBuffer,
    DWORD nOutBufferSize,
    LPDWORD lpBytesReturned
);

Parameters

  • dwIoControlCode
    [in] Control code for the operation. Use IOCTL_EDBG_DEREGISTER_CLIENT for this operation.
  • lpInBuffer
    [in] Set to NULL.
  • pId
    [in] Identifier of the client to deregister.
  • lpOutBuffer
    [in] Set to NULL.
  • nOutBufferSize
    [in] Set to zero.
  • lpBytesReturned
    [in] Set to NULL.

Return Values

Returns TRUE if successful; otherwise, returns FALSE.

Remarks

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

Requirements

Header

pkfuncs.h

See Also

Reference

EDBG IOCTLs
KITL IOCTLs