MAC_DRVR_EventPendingGet Function

TCPIP_MAC_EVENT MAC_DRVR_EventPendingGet( DRV_HANDLE hMac );

The currently stack pending events.

This function returns the currently pending Ethernet MAC events. Multiple events will be ORed together as they accumulate. The stack should perform processing whenever a transmission related event such as TCPIP_MAC_EV_RX_PKTPEND, or TCPIP_MAC_EV_TX_DONE, is present. The other, non critical events, may not be managed by the stack and passed to a user. They will have to be eventually acknowledged if re-enabling is needed.

• This is the preferred method to get the current pending MAC events. The stack maintains a proper image of the events from their occurrence to their acknowledgment.

• Even with a notification handler in place it's better to use this function to get the current pending events rather than using the events passed by the notification handler which could be stale.

• The events are persistent. They shouldn't be re-enabled unless they have been processed and the condition that generated them was removed. Re-enabling them immediately without proper processing will have dramatic effects on system performance.

• The returned value is just a momentary value. The pending events can change any time.

• MAC_DRVR_Initialize() should have been called.

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