1.2.5.2.26 TCPIP_MAC_Open Function

C

DRV_HANDLE TCPIP_MAC_Open(
    const SYS_MODULE_INDEX drvIndex, 
    const DRV_IO_INTENT intent
);

Description

This is the function that opens an instance of the MAC. Once a MAC client handle is obtained all the MAC functions can be accessed using that handle.

Precondtions

TCPIP_MAC_Initialize() should have been called.

Parameters

ParametersDescription
drvIndexIdentifier for the driver instance to be opened.
intentZero or more of the values from the enumeration DRV_IO_INTENT ORed together to indicate the intended use of the driver.

Returns

  • Valid handle - if the open function succeeded.

  • DRV_HANDLE_INVALID - If an error occurs.

Remarks

The intent parameter is not used in the current implementation and is maintained only for compatibility with the generic driver Open function signature.