Jump to main content

##

# 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

Parameters | Description
--- | ---
hMac | Handle identifying the MAC driver client
pRegEntries | Pointer to an array of TCPIP_MAC_STATISTICS_REG_ENTRY that will receive the current hardware statistics register. Can be NULL if not needed
nEntries | Number of TCPIP_MAC_STATISTICS_REG_ENTRY in the array
pHwEntries | Address to store the number of hardware supported registers by the associated MAC. Can be NULL if not needed