Guardian Procedure Calls Reference Manual

POOL64_AUGMENT_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Summary
The POOL64_AUGMENT_ procedure adds a secondary memory segment to an existing pool. The
caller must first allocate the memory space for the new segment.
A pool contains a primary segment, established initially by POOL64_DEFINE_, and may contain
secondary segments established by POOL64_AUGMENT_. Pool segments are generally not
contiguous. The word "segment" in this context refers to a virtual memory range designated as
part of the pool. A pool segment is not necessarily a segment in the memory-management sense.
Syntax for C Programmers
#include <kpool64.h>
int32 POOL64_AUGMENT_ ( NSK_POOL64_PTR pool_ptr
, void _ptr64 *new_segment_ptr
, uint64 new_segment_size );
Syntax for TAL Programmers
?SOURCE $SYSTEM.SYSTEM.KPOOL64
result := POOL64_AUGMENT_ ( pool_ptr ! i
,new_segment_ptr ! i
,new_segment_size ); ! i
Parameters
pool_ptr
input
INT .EXT64
pointer to a pool established by a call to the POOL64_DEFINE_ Procedure (page 959).
new_segment_ptr
input
EXT64ADDR
pointer to the segment to be added to the pool (must be a multiple of 16).
new_segment_size
input
INT(64)
size of the new segment being added (must be a multiple of 16).
954 Guardian Procedure Calls (P)