The keyboard class driver sends an IRP_MJ_INTERNAL_DEVICE_CONTROL request with the I/O control code IOCTL_INTERNAL_KEYBOARD_ENABLE to the port driver.
This request is sent to the class driver when the Win32 subsystem, or possibly a vendor-supplied device driver applet, requests a handle for the file object that represents the keyboard device object. A keyboard is a nonexclusive device. However, only the Win32 subsystem has sufficient privilege to read incoming keyboard data.
The Information field is set to zero. The class driver sets the Status field to STATUS_SUCCESS or to the error status returned by the port driver for the IOCTL_INTERNAL_KEYBOARD_ENABLE request.
Returns STATUS_SUCCESS, indicating that the port exists.
This request is sent to the port driver when the class driver’s DriverEntry routine calls IoGetDeviceObjectPointer as part of its attempt to layer itself above the port driver.
The port driver sets the Status field to STATUS_SUCCESS.
Cancels each IRP currently queued on behalf of the caller in the device queue of the class driver’s device object by setting STATUS_CANCELLED in the IRP’s I/O status block and completing the IRP. The next request on behalf of this caller will be an IRP_MJ_CLOSE.
Either the system is being shut down because the Win32 subsystem is releasing its file object handles, or the Win32 subsystem is releasing the handle of the class driver’s device on behalf of an application.
Always sets the Status field to STATUS_SUCCESS and the Information field to zero for the cleanup IRP.
The keyboard class driver sends an IRP_MJ_INTERNAL_DEVICE_CONTROL request with the I/O control code IOCTL_INTERNAL_KEYBOARD_DISABLE to the port driver.
This request is sent to the class driver following its completion of an IRP_MJ_CLEANUP request or when the system is being shut down.
Information is set to zero. The class driver sets Status to STATUS_SUCCESS or to the error status returned by the port driver for the IOCTL_INTERNAL_KEYBOARD_DISABLE request.
Returns STATUS_SUCCESS.
The port is being closed, normally only when the system is being shut down.
The port driver sets the Status field to STATUS_SUCCESS.
Transfers data from the device to the buffer at Irp->AssociatedIrp.SystemBuffer. The device data is packaged into one or more keyboard data packets defined as follows:
typedef struct KEYBOARD_INPUT_DATA {
USHORT UnitId; // zero-based unit number of the keyboard port
USHORT MakeCode; // the make scan code (key depression)
USHORT Flags; // indicates a break (key release) and
// other miscellaneous scan-code info
USHORT Reserved;
ULONG ExtraInformation; // device-specific additional
// information for the event
} KEYBOARD_INPUT_DATA, *PKEYBOARD_INPUT_DATA
Any time after the IRP_MJ_CREATE request has been completed with STATUS_SUCCESS. A read request can be completed successfully only if it was made by a trusted subsystem, that is, by the Win32 subsystem. The class driver performs a privilege check to enforce this restriction.
The Information field always contains the number of bytes read into the system buffer. This is at most the requested length and at least one keyboard data packet when the Status field is set to STATUS_SUCCESS. Otherwise, the Status field can be set to STATUS_BUFFER_TOO_SMALL, STATUS_PRIVILEGE_NOT_HELD, or STATUS_CANCELLED, and no data is returned.
Clears the keyboard class driver’s internal data queue and flushes the keyboard device buffer, if applicable.
Not currently. Reserved for future use.
The Status field is set to STATUS_SUCCESS and the Information field is zero.
Determined by the I/O control code set at Parameters.DeviceIoControlCode.IoControlCode in the driver’s I/O stack location of the IRP. The system-supplied keyboard class driver usually performs sanity checks on the validity of the parameters for the I/O control code, determines the target UnitId (port) for the request, and then passes the request on to the port driver.
Drivers should validate the input UnitId, which is a zero-based value identifying the target keyboard port, for all I/O control codes for which the corresponding structures have this member. A driver should fail the request when an input UnitId value is out of range for the number of keyboards it supports.
The Win32 subsystem, or possibly a vendor-supplied device driver applet, has called DeviceIoControl to communicate a request to the keyboard driver.
The Status field value depends on the operation, either STATUS_SUCCESS or an appropriate STATUS_XXX value. For most operations, the set of possible STATUS_XXX values includes those propagated from a call to a support routine or the port driver and /or those chosen by the driver designer. In general, the Information field of the I/O status block is set to the number of bytes of returned data when the device driver completes the IRP.
The following section Keyboard I/O Control Codes summarizes the I/O control codes handled by keyboard drivers.