KSDIAGMODE (Enable/Disable Diagnostics Mode)

Purpose

Enables/disables diagnostics mode.

Syntax

#include <sys/inputdd.h>

int ioctl (FileDescriptor, KSDIAGMODE, Arg)
uint *Arg;

Description

The KSDIAGMODE ioctl subroutine call enables and disables keyboard diagnostics mode. When diagnostics mode is enabled, the keyboard driver undefines the keyboard driver interrupt handler and stops processing keyboard events. When diagnostics mode is disabled, the keyboard driver redefines its interrupt handler, then resets and reconfigures the keyboard.

When keyboard diagnostics mode is enabled, the following keyboard ioctl subroutine calls fail and set the errno global variable to a value of EBUSY:

• KSLED
• KSCFGCLICK
• KSVOLUME
• KSALARM
• KSTRATE
• KSTDELAY

Parameters

Return Values

The KSDIAGMODE ioctl subroutine call returns a value of -1 and sets the errno global variable to a value of EINVAL when called by a kernel extension. The KSDIAGMODE ioctl subroutine call sets the errno global variable to a value of EBUSY on the RS1/RS2 platform when the tablet special file is open.

Implementation Specifics

This ioctl subroutine call is part of Base Operating System (BOS) Runtime.