Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

◄Overview►                                            ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_VIO
 
USHORT VioEndPopUp(hvio)
HVIO hvio;    /* video handle */
 
The VioEndPopUp function closes a pop-up screen and restores the physical
video buffer to its previous contents. Only the process that opened the
pop-up screen may close it.
 
VioEndPopUp may not completely restore the screen to its previous state. For
example, programs that modify the video registers or use graphics modes may
have to restore the state of the registers as the pop-up screen is being
closed. By calling the VioModeWait function, a program can request to be
notified of the change in video mode. Whenever a process has a pending
request, MS OS/2 notifies the process of a mode change when the pop-up
screen is closed.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hvio       Identifies an advanced video-input-and-output (AVIO) presentation
           space. For AVIO programs, this handle must have been created
           previously using the VioCreatePS function. For other programs,
           hvio must be NULL.
 
Return Value
 
The return value is zero if the function is successful. Otherwise, it is an
error value, which may be one of the following:
 
     ERROR_VIO_INVALID_HANDLE
     ERROR_VIO_NO_POPUP
 
Example
 
This example creates a pop-up screen, displays a message, waits three
seconds, then calls VioEndPopUp to close the pop-up screen:
 
USHORT fWait = VP_WAIT;
VioPopUp(&fWait, 0);                /* creates pop-up screen */
VioWrtTTY("This is a VIO pop-up screen\n\r", 29, 0);
DosSleep(3000L);                    /* waits 3 seconds       */
VioEndPopUp(0);                     /* ends pop-up screen    */
 
See Also
 
VioModeWait, VioPopUp, VioCreatePS
 
                                      ♦