ioctl12.hlp (Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
KBD_SETFGNDSCREENGRP (1.2)
                                                      Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_DOSDEVIOCTL
 
USHORT DosDevIOCtl(0L, pusScreenGrp, 0x0055, 0x0004, hDevice)
PUSHORT pusScreenGrp;    /* pointer to structure with screen group */
HFILE hDevice;           /* device handle                          */
 
The KBD_SETFGNDSCREENGRP function sets the new foreground screen group. When
the keyboard switches to the new screen group, it switches to the shift
state, input buffer, and monitor chain defined for that screen group.
 
This function is reserved for the session manager.
 
Parameter     Description
────────────────────────────────────────────────────────────────────────────
 
pusScreenGrp  Points to the SCREENGROUP structure that contains the
              screen-group identifier of the new foreground screen group.
 
hDevice       Identifies the keyboard that receives the device-control
              function. The handle must have been created previously by
              using the DosOpen function.
 
Return Value
 
The return value is zero if the function is successful or an error value if
an error occurs.
 
See Also
 
DosOpen, KBD_SETSESMGRHOTKEY, SCREENGROUP
 
                                      ♦