PxOpoolGetType()

Return the object pool type.

APPLIES TO

8.2.0

SYNOPSIS
PxOpoolType_t PxOpoolGetType (PxOpool_t OpoolId);
ARGUMENTS
OpoolId

An object pool id

RETURN VALUES
  • The object pool type

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

PxOpoolGetType returns the type of the given object pool. The type can be either PXOpoolVirtual, PXOpoolReal, or PXOpoolIllegalType if an invalid object pool is given.

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 PXOpoolIllegalType 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"

PxOpoolType_t Type = PxOpoolGetType(OpoolId);