This is an old revision of the document!
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).
Example Code
C Binding
<PRE> #define INCL_VIO
USHORT rc = VioScrUnLock(VioHandle);
HVIO VioHandle; /* Video handle */
USHORT rc; /* return code */ </PRE>
MASM Binding
<PRE> EXTRN VioScrUnLock:FAR INCL_VIO EQU 1
PUSH WORD VioHandle ;Video handle CALL VioScrUnLock
Returns WORD </PRE>
Note
Text based on http://www.edm2.com/index.php/VioScrUnLock_(FAPI)