en:docs:fapi:vioscrunlock

This is part of Family API which allow to create dual-os version of program runs under OS/2 and DOS

Note: This is legacy API call. It is recommended to use 32-bit equivalent

2021/09/17 04:47 · prokushev · 0 Comments
2021/08/20 03:18 · prokushev · 0 Comments

VioScrUnLock

This call releases ownership of (unlocks) the physical display buffer.

Syntax

VioScrUnLock (VioHandle)

Parameters

  • VioHandle (HVIO) - input : Reserved word of 0s.

Return Code

rc (USHORT) - return

Return code descriptions are:

  • 0 NO_ERROR
  • 367 ERROR_VIO_UNLOCK
  • 430 ERROR_VIO_ILLEGAL_DURING_POPUP
  • 436 ERROR_VIO_INVALID_HANDLE
  • 465 ERROR_VIO_DETACHED
  • 494 ERROR_VIO_EXTENDED_SG

Remarks

This call releases the screen lock that is set by VioScrLock. The VioScrUnLock call must be issued by a thread in the same process as the thread that issued VioScrLock.

Family API Considerations

Some options operate differently in the DOS mode than in the OS/2 mode. Therefore, the following restriction applies to VioScrUnLock when coding in the DOS mode:

The status always indicates the unlock is successful (return code = 0).

Bindings

C Binding

#define INCL_VIO
 
USHORT  rc = VioScrUnLock(VioHandle);
 
HVIO             VioHandle;     /* Video handle */
 
USHORT           rc;            /* return code */

MASM Binding

EXTRN  VioScrUnLock:FAR
INCL_VIO            EQU 1
 
PUSH   WORD    VioHandle     ;Video handle
CALL   VioScrUnLock
 
Returns WORD

Note