VioShowBuf (FAPI)

Legacy Function Warning
It is recommended to use a newer replacement for this function.
Replacement:	VioShowBuf
Remarks:	This page list the older version of the function for reference.

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.

Example Code

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

Related Functions

VioGetBuf