User`s guide

Dialogic
®
System Release 6.0 PCI for Windows
®
Release Update, Rev 62 — January 30, 2008 369
Dialogic Corporation
dt_getstatistics( )
 Description
The dt_getstatistics( ) function returns the statistics queried. The application must specify the
type of statistics to be queried in the m_StatisticsType field in the TsdtStatisticsList structure. The
m_nStatisticsCount field specifies the number of statistics returned. The statistics are available as
an array of TSdtLayer1Statistics structures. In asynchronous mode (EV_ASYNC) the list of
statistics is part of the event data.
The dt_getstatistics( ) function uses the following data structures either directly or indirectly:
• dtStatisticsType, which is defined as follows:
typedef enum
{
dtStatisticsType_Invalid = 0, /* No statistics to be collected */
dtStatisticsType_Layer1, /* All Layer 1 Statistics */
dtStatisticsType_Max
}dtStatisticsType;
• dtStatisticsMode, which is defined as follows:
typedef enum
{
dtStatisticsMode_Invalid = 0, /* No statistics Mode */
dtStatisticsMode_Clear, /* Clear statistics counters */
dtStatisticsMode_Preserve, /* Preserve statistics counters */
dtStatisticsMode_Max
}dtStatisticsMode;
• dtLayer1StatisticsId, which is defined as follows:
Name: int dt_getstatistics(a_hSrlDevice, a_statisticsList, a_mode)
Inputs: int a_hSrlDevice
• logical board device handle (for example, dtiB1)
TSdtStatisticsList* a_statisticsList
• pointer to statistics
unsigned short a_mode
• synchronous/asynchronous
Returns: 0 for success
-1 for failure
Includes: srllib.h
dtilib.h
Category: Statistics Functions
Mode: synchronous/asynchronous
Parameter Description
a_hSrlDevice SRL handle for logical board device
a_statisticsList pointer to TSdtStatisticList structure
a_mode EV_SYNC or EV_ASYNC