INQ_CALLING_SEGMENT(3G)

NAME

inq_calling_segment_list, inq_calling_segment_count − return information about segments calling a given segment

SYNOPSIS

C Syntax:

void inq_calling_segment_count(fildes,segno,seg_count)
int fildes,segno,*seg_count;

void inq_calling_segment_list(fildes,segno,seg_list)
int fildes,segno,seg_list[];

FORTRAN77 Syntax:

subroutine inq_calling_segment_count(fildes,segno,seg_count)
integer*4 fildes,segno,seg_count

subroutine inq_calling_segment_list(fildes,segno,seg_list)
integer*4 fildes,segno,seg_list(*)

Pascal Syntax:

procedure inq_calling_segment_count(fildes,segno:integer;
var seg_count:integer);

procedure inq_calling_segment_list(fildes,segno:integer;
var seg_list: array[lo..hi: integer] of integer);

DESCRIPTION

Input Parameters

fildes Integer file descriptor returned by gopen when an I/O path to a graphics device is opened.

segno Segment name.

Output Parameters

seg_count Number of segments calling the specified segment.

seg_list Buffer in which the list of segments calling the specified segment is returned.

Discussion

Inq_calling_segment_list and inq_calling_segment_count return information about the segments that call the specified segment.

Inq_calling_segment_count returns the number of segments calling the specified segment. The seg_list parameter passed to inq_calling_segment_list must be at least this size.

Inq_calling_segment_list returns, in the specified buffer seg_list, the list of segment names of those segments which call the specified segment.

ERRORS

1 Graphics device is not initialized for this operation.

Museum

Related Articles