Share via


IOCTL_EDBG_SET_DEBUG (Compact 2013)

10/16/2014

This I/O control message controls the debug print output for a KITL subsystem. Send this message with KernelIoControl.

Syntax

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

Parameters

  • dwIoControlCode
    [in] Control code for the operation. Use IOCTL_EDBG_SET_DEBUG for this operation.
  • lpInBuffer
    [in] Set to NULL.
  • ZoneMask
    [in] Specifies the debug zone mask.
  • 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

This I/O control message controls debug messages that are written to the debug serial port based on the value specified in ZoneMask. For more information about KITL debug zone definitions, see %_WINCEROOT%\Public\Common\Oak\Inc\Kitlprot.h.

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

Requirements

Header

pkfuncs.h

See Also

Reference

EDBG IOCTLs
KITL IOCTLs