NAME

INQUIRE POSTED STRUCTURES − inquire the list of structures posted to a workstation

SYNOPSIS

C Syntax

void
pinq_posted_structs ( ws, length, start, error_ind, list, total_length )
Pintws;workstation identifier
Pintlength;length of application list
Pintstart;starting position
Pint∗error_ind;OUT error indicator
Pposted_struct_list∗list; OUT list of posted structures
Pint∗total_length;OUT length of list in PHIGS

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE POSTED STRUCTURES to obtain the list of currently posted structures from a workstation’s state list. 

C Input Parameters

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

lengthThe number of postings in the list output parameter for which the application has allocated memory. length is the number of list elements (posted structures) that the system can return in list→postings.  If a value of 0 is used here, no data will be returned in the list→postings list, but the total number of posted structures in the PHIGS state list will be returned in total_length. 

startStarting position of inquiry into the PHIGS state list of current structures. The elements of the list of posted structures, beginning with the item number specified by start, are copied sequentially into list→postings until list→postings is full or all the posted structures have been copied. 

C Output Parameters

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

listA pointer to a Pposted_struct_list in which the system returns the portion of the list of currently posted structures starting at the entry specified with start.  Pposted_struct_list is defined in phigs.h as follows:

typedef struct {
Pintnum_postings;/∗ number of structure postings ∗/
Pposted_struct∗postings;/∗ list of postings ∗/

} Pposted_struct_list;

The pointer list→postings must be initialized to an array of length Pstructpost elements.  Pposted_struct is defined in phigs.h as follows:

typedef struct {
Pintid;/∗ structure id ∗/
Pfloatdisp_pri;/∗ structure priority ∗/

} Pposted_struct;

total_length
A pointer to an integer in which the system returns the total number of elements in the PHIGS state list of currently used posted structures. This is the value required for length if all posted structures are to be returned. 

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)

ALSO

POST STRUCTURE (3P)
INQUIRE SET OF WORKSTATIONS TO WHICH POSTED (3P)
INQUIRE PATHS DESCENDENTS (3P)

September 02, 1992