.Buffrq Method

Top  Previous  Next

Function:

Pre-requests "numpages" number of buffer pages (1 page= 256 bytes) for the TX buffer of the ppp. object.

Syntax:

ppp.buffrq(numpages as {byte | word}) as {byte | word}

Returns:

Actual number of pages that can be allocated.

See Also:

ppp.buffsize

 


Part

Description

numpages

Requested numbers of buffer pages to allocate (recommended value is 5).

Details

Actual allocation happens when the sys.buffalloc method is used.

The PPP object will be unable to operate properly if its buffer has inadequate capacity. Recommended buffer size is 5 pages.

The buffer can only be allocated when the PPP channel is not enabled (ppp.enabled= 0- NO). Executing sys.buffalloc while ppp.enabled= 1- YES will leave the buffer size unchanged.

The actual current buffer size can be verified through the ppp.buffsize read-only property.

 

Older devices had smaller RAM sizes, so the numpages argument and the value returned by the method were of the byte type. The maximum possible number of pages, therefore, could not exceed 255. On newer devices with larger RAM capacities this method takes and returns word values. Inspect the method's declaration on the platform you are using to make sure you know the data type it employs.