en:docs:fapi:vioshowbuf

This is an old revision of the document!


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

<PRE> #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 */ </PRE>

MASM Binding

<PRE> 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 </PRE>

Note