Virtual Devices (3.1) (vdag31qh.hlp) (Table of Contents; 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.
VCD_Get_Focus
                                                     Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
include vcd.inc
 
VxDcall VCD_Get_Focus
 
The VCD_Get_Focus service returns the virtual machine handle of the current
owner of a COM port. Focus can be set with a Set_Device_Focus control
message sent using the System_Control service and specifying the VCD
device.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
EAX        Specifies the hardware COM port number. It must be in the range 1
           to 4.
 
Return Value
 
If the carry flag is clear, the EBX register contains virtual machine handle
or zero if there is no owner.
 
The carry flag is set if the port is not available.
 
Uses
 
EBX, Flags
 
                                      ♦