Share via

KD_IOCTL_KERNEL_HALT (Compact 2013)

  • Article

10/16/2014

This I/O control message notifies the BSP that the kernel debugger is about to halt the device. The kernel debugger sends this message with OEMKDIoctl.

Syntax

BOOL OEMKDIoControl(
    DWORD dwIoControlCode,   // use KD_IOCTL_KERNEL_HALT
    LPVOID lpInBuffer,       // pointer to input buffer
    DWORD nInBufferSize      // input buffer size
);

Parameters

  • dwIoControlCode
    [in] Control code for the operation. Use KD_IOCTL_KERNEL_HALT for this operation.
  • lpInBuffer
    [in] Set to NULL.
  • nInBufferSize
    [in] Set to zero.

Return Values

TRUE if successful; otherwise, FALSE.

Remarks

This IOCTL must be implemented to support the Platform Builder kernel debugger on target platforms that contain independent resources that must be deactivated for a CPU halt. These include any parallel processing elements such as math coprocessors, modems, audio processors, and any similar elements.

The implementation of this IOCTL must place these elements in a halted state before returning.

Requirements

Header

pkfuncs.h

See Also

Reference

Kernel Debugger IOCTLs
KD_IOCTL_KERNEL_CONTINUE
OEMKDIoctl