MAC_DRVR_RegisterStatisticsGet Function

C

TCPIP_MAC_RES MAC_DRVR_RegisterStatisticsGet(
    DRV_HANDLE                          hMac,
    TCPIP_MAC_STATISTICS_REG_ENTRY *    pRegEntries,
    int                                 nEntries,
    int *                               pHwEntries
    );

Returns

  • TCPIP_MAC_RES_OK if all processing went on OK.

  • TCPIP_MAC_RES_OP_ERR error code if function not supported by the driver.

Description

This function will get the current value of the statistic registers of the associated MAC controller.

Remarks

  • The reported values are info only and change dynamically.

Preconditions

  • MAC_DRVR_Initialize() should have been called.

  • MAC_DRVR_Open() should have been called to obtain a valid handle.

Parameters

ParametersDescription
hMacHandle identifying the MAC driver client
pRegEntriesPointer to an array of TCPIP_MAC_STATISTICS_REG_ENTRY that will receive the current hardware statistics register. Can be NULL if not needed
nEntriesNumber of TCPIP_MAC_STATISTICS_REG_ENTRY in the array
pHwEntriesAddress to store the number of hardware supported registers by the associated MAC. Can be NULL if not needed