RtndQueryMacAddress

RtndQueryMacAddress gets the MAC address of an interface.

Syntax

Copy

BOOL RtndQueryMacAddress(
  [in]    ULONG_PTR RtndInterfaceId,
  [out]   BYTE *pMacAddress
);

Parameters

[in] RtndInterfaceId

The number or pointer used to identify the interface. This value is returned by RtndManageInterface.

[out] pMacAddress

The MAC address of the interface.

Return Value

If the function succeeds, it returns TRUE. If the function fails, it returns FALSE. To get extended error information, call GetLastError.

Remarks

The NL2 always calls RtndQueryMacAddress from the main thread of the NL2 process. The NL2 never calls RtndQueryMacAddress before a successful call to RtndStartInterface.

Characteristics

Real-time requirements
Deterministic behavior	Not required
Local memory allocation/deallocation restrictions
Process	External MSpace	Internal MSpace
System	Allowed	Allowed
Process	Allowed	Allowed
Contiguous memory allocation/deallocation restrictions
Contiguous memory	Allowed

Requirements

Minimum supported version	Header
eRTOS 1.0 SDK	Rtnd.h