Expands the count of available pinned storage elements contained within an ldata pool.
The ldata_grow kernel service increases the number of pinned storage elements contained within a per-SRAD sub-pool associated with the ldata handle ldatap, by count. If the ldata_alloc call fails because there are no more free pinned storage elements in a sub-pool, use the ldata_grow kernel service. The ldata_grow kernel service pins additional count elements from the sub-pool and makes them available for the ldata_alloc call. All of the sub-pools associated with the handle are grown. If count elements are not available or there is not enough pinned memory available, the ldata_grow kernel service fails.
Item | Description |
---|---|
ldatap | Specifies the handle of the ldata pool. |
count | Specifies the additional number of storage elements to be pinned in the sub-pool. The count value should be greater than 0 and should not increase the sub-pool size beyond the value of maxcount specified with the ldata_create call. |
The ldata_grow kernel service can be called only from the process environment.
Item | Description |
---|---|
0 | Success. |
-1 | Error encountered. Illegal parameters or insufficient resources. |
The ldata_grow kernel service is part of the Base Operating System (BOS) Runtime.