en:docs:fapi:vioshowbuf

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

VioShowBuf

This call updates the physical display buffer with the logical video buffer (LVB).

Syntax

VioShowBuf (Offset, Length, VioHandle)

Parameters

  • Offset (USHORT) - input : Starting offset within the logical video buffer at which the update to the screen is to start.
  • Length (USHORT) - input : Length of the area to be updated to the screen.
  • VioHandle (HVIO) - input : This must be zero unless the caller is a Presentation Manager application, in which case it must be the value returned by VioGetPs.

Return Code

rc (USHORT) - return

Return code descriptions are:

  • 0 NO_ERROR
  • 355 ERROR_VIO_MODE
  • 430 ERROR_VIO_ILLEGAL_DURING_POPUP
  • 436 ERROR_VIO_INVALID_HANDLE
  • 465 ERROR_VIO_DETACHED

Remarks

VioShowBuf is ignored unless it is issued by a process that has previously called VioGetBuf and that is currently executing in the foreground.

PM Considerations

This function updates the display with the Advanced VIO presentation space.

Bindings

C Binding

#define INCL_VIO
 
USHORT  rc = VioShowBuf(Offset, Length, VioHandle);
 
USHORT           Offset;        /* Offset into LVB */
USHORT           Length;        /* Length */
HVIO             VioHandle;     /* Video handle */
 
USHORT           rc;            /* return code */

MASM Binding

EXTRN  VioShowBuf:FAR
INCL_VIO            EQU 1
 
PUSH   WORD    Offset        ;Offset into LVB
PUSH   WORD    Length        ;Length
PUSH   WORD    VioHandle     ;Video handle
CALL   VioShowBuf
 
Returns WORD

Note