INQUIRE DISPLAY UPDATE STATE(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

INQUIRE DISPLAY UPDATE STATE − inquire the current display update state

SYNOPSIS

C Syntax

void
pinq_disp_upd_st ( ws, error_ind, def_mode, mod_mode, display_empty, state )
Pintws;workstation identifier
Pint∗error_ind;OUT error indicator
Pdefer_mode∗def_mode;OUT deferral mode
Pmod_mode∗mod_mode;OUT modification mode
Pdisp_surf_empty∗disp_empty; OUT display surface empty
Pvisual_st∗state;OUT state of visual representation

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE DISPLAY UPDATE STATE to determine the current display update state from a specified workstation’s state list.

The deferral mode and modification mode were set by the application. The display surface empty and state of visual representation state list values are maintained by PHIGS.

C Input Parameters

wsThe workstation identifier of the workstation whose state list is queried.

C Output Parameters

error_ind
A pointer to the location to store the error number of any error detected by this function.

def_mode
A pointer to a location in which the system returns the current deferral mode. Possible values for Pdefer_mode are defined in phigs.h as follows: PDEFER_ASAPMake the display visually correct — As Soon As Possible PDEFER_BNIGMake the display visually correct — Before the Next Interaction Globally PDEFER_BNILMake the display visually correct — Before the Next Interaction Locally PDEFER_ASTIMake the display visually correct — At Some Time PDEFER_WAIT Make the display visually correct — When the Application Requests It

mod_mode
A pointer to a location in which the system returns the current modification mode. Possible values for Pmod_mode are defined in phigs.h as follows: PMODE_NIVENo Immediate Visual Effects PMODE_UWOR Update Without Regeneration PMODE_UQUMUse Quick Update Methods

display_empty
A pointer to a location in which the system returns the current display surface empty status. Possible values for Pdisp_surf_empty are:

PSURF_EMPTYEmpty
PSURF_NOT_EMPTYNot Empty

stateA pointer to a location in which the system returns the current state of visual representation. Possible values for Pvisual_st are:

PVISUAL_ST_CORRECTCorrect
PVISUAL_ST_DEFERDeferred
PVISUAL_ST_SIMULATEDSimulated

ERRORS

003Ignoring function, function requires state (PHOP, WSOP, ∗, ∗)

054Ignoring function, the specified workstation is not open

059Ignoring function, the specified workstation does not have output capability (that is, the workstation category is neither OUTPUT, OUTIN, nor MO)

Museum