Options (PULONG) - input

      Option flags.

        Bit

          Description
        31-2
          Reserved. Set to 0.
        1
          0 = Non-transparent operation. The video mode is set to a text mode. The screen is cleared, and the cursor is positioned at the upper-left corner of the screen.
          1 = Transparent operation. If the video mode of the outgoing foreground session is a text mode, no mode change occurs. The screen is not cleared, and the cursor remains at its current position. If the video mode is not text, or if this session has a VioSavRedrawWait active, the pop-up is refused.

          The OS/2 operating system is responsible for saving and restoring the physical display buffer of the previous foreground session around a pop-up. This is true whether transparent or nontransparent operation is selected.

        0
          0 = Return with unique error code, ERROR_VIO_EXISTING_POPUP, if pop-up is not immediately available.
          1 = Wait if pop-up is not immediately available.

        VioHandle (HVIO) - input

          Presentation-space handle.

          This must be 0, unless the caller is a Presentation Manager application; in this case, it must be the value returned by VioCreatePS.

        rc (APIRET) - returns

          Return code.

          VioPopUp returns one of the following values:

        • NO_ERROR 405
            ERROR_VIO_NO_POPUP
          406
            ERROR_VIO_EXISTING_POPUP
          421
            ERROR_VIO_INVALID_PARMS
          483
            ERROR_VIO_TRANSPARENT_POPUP


          [Back] [Next]