en:docs:fapi:vioshowbuf
no way to compare when less than two revisions

Differences

This shows you the differences between two versions of the page.


Previous revision
Next revision
en:docs:fapi:vioshowbuf [2021/08/20 02:31] prokushev
Line 1: Line 1:
 +{{logos:os2.gif?35x35}} {{logos:dos.gif?35x35}}
 +====== 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. 
 +
 +===== Example Code =====
 +==== C Binding ====
 +<code c>
 +#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 */
 +</code>
 +
 +==== MASM Binding ====
 +<code asm>
 +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
 +</code>
 +
 +
 +
 +====== Note ======
 +
 +Text based on [[http://www.edm2.com/index.php/VioShowBuf_(FAPI)]]
 +
 +{{page>en:templates:fapi}}
 +
 +