Versions Compared

Old Version 12

changes.mady.by.user Former user

Saved on

compared with

New Version 13

changes.mady.by.user Former user

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from this space and version 3.03.00

Get network interface’s hardware address.

Files

net_if.h/net_if.c

Prototype

Arguments

if_nbr

Network interface number to get the hardware address.

p_addr_hw

Pointer to variable that will receive the hardware address.

p_addr_len

Pointer to a variable to pass the length of the address buffer pointed to by p_addr_hw and return the size of the returned hardware address, if no errors.

p_err

Pointer to variable that will receive the return error code from this function:

NET_IF_ERR_NONE
NET_IF_ERR_NULL_PTR
NET_IF_ERR_NULL_FNCT
NET_IF_ERR_INVALID_IF
NET_IF_ERR_INVALID_CFG
NET_IF_ERR_INVALID_ADDR_LEN
NET_ERR_FAULT_LOCK_ACQUIRE

Returned Value

None.

Required Configuration

None.

Notes / Warnings

The hardware address is returned in network-order; i.e., the pointer to the hardware address points to the highest-order byte. Additional error codes may be returned by the specific interface or device driver.