Guardian Procedure Calls Reference Manual

POOL64_GET_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Summary
The POOL64_GET_ procedure allocates an element from the specified pool. The size parameter
specifies the amount of memory requested. Upon successful allocation, the base address is a
multiple of 16. The allocated size may be slightly larger than required.
Syntax for C Programmers
#include <kpool64.h>
void _ptr64 * POOL64_GET_ ( NSK_POOL64_PTR pool_ptr
,uint64 size_needed
,uint32 _ptr64 *error );
Syntax for TAL Programmers
?SOURCE $SYSTEM.SYSTEM.KPOOL64
pool_mem := POOL64_GET_ ( pool_ptr ! i
,size_needed ! i
,error ); ! o
Parameters
pool_ptr
input
INT .EXT64
pointer to a pool established by a call to the POOL64_DEFINE_ Procedure (page 959).
size_needed
input
INT(64)
specifies the payload size that is needed from the pool, excluding any pool overhead.
error
output
INT(32) .EXT64
indicates the outcome of the call:
POOL64_OK0
Successful completion.
POOL64_INVALIDSIZE4
Size requested is larger than the maximum possible request.
964 Guardian Procedure Calls (P)