Jump to main content

##

# 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

Parameters | Description
--- | ---
drvIndex | Identifier for the driver instance to be opened.
intent | Zero 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.