onlinedokumentation

CheckMode

There is a special assistance for the developing phase. Some run-time checks are done when KS_… functions are being called. The following checks are carried out:

Checks for valid handles:

  • Callback handle
  • Event handle
  • Internal keyboard handle
  • Filter handle
  • Interrupt handle
  • Serial port handle
  • Internal device handle
  • USB device handle
  • Real-time timer handle
  • Task handle
  • Semaphore handle
  • Internal driver object handle
  • Network adapter handle
  • Socket handle
  • MultiFunction board handle
  • CAN port handle
  • CANopen master handle
  • CANopen slave handle
  • CANopen dataset handle
  • EtherCAT master handle
  • EtherCAT slave handle
  • EtherCAT dataset handle
  • EtherCAT reflection handle
  • Profibus card handle
  • Profibus master handle
  • Profibus slave handle
  • Profibus dataset handle
  • PLC variable handle

Other checks:

  • <none>

Due to the time-consuming validation, the checks are normally only carried out if the programmer is in the developing phase. This will be recognized according to a developer installation being found. Both can be overridden by a registry entry.

Developer installation Final installation
Checks Yes No
Override by “CheckMode” = 0 “CheckMode” = 1

In order to override the current setting, lookup for the DWORD entry in

HKLM\SOFTWARE\Kithara\Drivers\<your_package_name>\CheckMode

and set it to “0” or “1”, respectively.