Jump to main content

##

# 1.2.5.2.45 TCPIP_MAC_RegisterStatisticsGet Function

## C

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

## Description

This function will get the current value of the statistic registers maintained by the MAC hardware.

## Precondtions

TCPIP_MAC_Initialize() should have been called. TCPIP_MAC_Open() should have been called to obtain a valid handle.

## Parameters

Parameters | Description
--- | ---
hMac | Handle identifying the MAC driver client.
pRegStatistics | Pointer to a pRegEntries that will receive the current hardware statistics registers values. Can be 0, if only the number of supported hardware registers is requested.
nEntries | Provides the number of TCPIP_MAC_STATISTICS_REG_ENTRY structures present in pRegEntries Can be 0, if only the number of supported hardware registers is requested The register entries structures will be filled by the driver, up to the supported hardware registers.
pHwEntries | Pointer to an address to store the number of the statistics registers that the hardware supports It is updated by the driver. Can be 0 if not needed.

## 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.

## Remarks

The reported values are info only and change dynamically.