KbdGetHWId

Returns the attached keyboard's hardware-generated Identification value.

KbdGetHWId

(KeyboardID, KbdHandle)

KeyboardID (PKBDHWID) - input

Pointer to the caller's data area where the following structure and data values are:

length (USHORT) - input/output

On input, this field should contain the length of the KeyboardID structure. The minimum input length value allowed is 2. On output, this field contains the actual number of bytes returned.
keybdid (USHORT) - output
OS/2 supported keyboards and their hardware generated IDs are as follows:

ID

Keyboard
0000H
Undetermined keyboard type
0001H
PC-AT Standard Keyboard
AB41H
101 Key Enhanced Keyboard
AB41H
102 Key Enhanced Keyboard
AB54H
88 and 89 Key Enhanced Keyboards
AB85H
122 Key Enhanced Keyboard
reserved (USHORT)
Reserved and returned set to zero.
reserved (USHORT)
Reserved and returned set to zero.
KbdHandle (HKBD) - input
Word identifying the logical keyboard.
rc (USHORT) - return
Return code descriptions are:
• NO_ERROR 373
  ERROR_KBD_PARAMETER
  447
  ERROR_KBD_KEYBOARD_BUSY
  464
  ERROR_KBD_DETACHED
  504
  ERROR_KBD_EXTENDED_SG
  Remarks

  In past OS/2 releases, all keyboards could be supported by knowing the hardware family information available with keyboard IOCTL 77H. However, with the addition of the 122-key keyboard, recognition was not containable by hardware family information alone. The 122-key keyboard has a number of differences from other keyboards. Therefore, applications performing keystroke specific functions may need to determine specifically which keyboard is attached.

  This function is of particular usefulness for applications providing Custom Translate Tables and mapping keyboard layouts.

  ---

  [Back: KbdGetFocus]
  [Next: KbdGetStatus]