AIDA_boGetStatistics

The AIDA_boGetStatistics function retrieves statistics information for a given stack level.

bool AIDA_boGetStatistics(
  handle hStack,
  byte bStackLevel,
  AIDA_tstStatistics *pstStatistics
);

Parameters

hStack
Specifies the AIDA stack from which the statistics information shall be retrieved.
bStackLevel
Specifies the level for which the statistics information shall be retrieved.
pstStatistics
Specifies the location of an AIDA_tstStatistics structure where the function shall store the statistics information.

Return Values

AIDA_boGetStatistics returns true if the stack accepts the request.

In case of failure the function will return false. The application can retrieve the error code using AIDA_iGetError.

Remarks

In case of counter overflows the AIDA library will scale down all counters by 50%. This behaviour ensures that the relations between the counters stay correct.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Linux: Requires a kernel supporting ELF binaries.
  Header: Declared in bsk_aida.h, also requires portab.h.
  Import Library (Windows): Use BSK_AIDA.lib.

See Also

AIDA Overview, AIDA Functions, AIDA_dwGetStackStatus, AIDA_boSetStackOnline, AIDA_boSetStackOffline, AIDA_boResetStatistics