PxOpoolGetCurrentCapacity()

Return the current capacity of an object pool.

APPLIES TO

1.0.0

SYNOPSIS
PxUInt_t PxOpoolGetCurrentCapacity (PxOpool_t OpoolId);
ARGUMENTS
OpoolId

An object pool id

RETURN VALUES
  • The current capacity of the given object pool

ERROR CODES

PXERR_OPOOL_ILLOPOOL

OpoolId is not a valid object pool id

PXERR_GLOBAL_ILLEGAL_CORE

The requested object pool is not on the same core

DESCRIPTION

PxOpoolGetCurrentCapacity returns the current capacity in opool. This is the actual number of available objects only for real object pools. For virtual objects pools, it describes the number of objects that can be obtained from the object pool, provided that its source has sufficient capacity. If PxOpoolGetCurrentCapacity returns 0, either the object pool is empty or an error has occurred. Call PxGetError to see if an error occurred.

IMPLEMENTATION GUIDELINES
Before call
  • OpoolId must be a valid PXROS-HR object pool. The validity of OpoolId may be checked by the following macros:

    • PxOpoolIdIsValid() must be true.

    • PxOpoolIdGet() must not be _PXIllegalObjId.

    • PxOpoolIdError() must be PXERR_NOERROR otherwise the returned error code has to be interpreted (C).

After call
  • The function returns 0 if the given object pool is invalid. In this case PxGetError must be called to check which error has occurred. (F)

Best Practice
  • No restrictions.

SEE ALSO
USAGE
#include "pxdef.h"

PxUInt_t Cap = PxOpoolGetCurrentCapacity(OpoolId);