...
NetDev_AddrMulticastRemove()
...
The next API function is the AddrMulticastRemove() function used to remove an (IP-to-Ethernet) multicast hardware address from a device.anchor
Files
Anchor
net_dev.canchorPrototype
anchor
...
| rowspan | 2 |
|---|
...
Note that since every device driver’s AddrMulticastRemove() function is accessed only by function pointer via the device driver’s API structure, it doesn’t need to be globally available and should therefore be declared as ‘static’.Anchor
static’.Arguments
Anchor
pifPointer to the interface to remove a multicast address.
Anchor
paddr_hwPointer to multicast hardware address to remove.
Anchor
addr_hw_lenLength of multicast hardware address.
Anchor
perrPointer to variable that will receive the return error code from this function.
...
Returned Value
...
Required Configuration
...
Necessary only if NET_IP_CFG_MULTICAST_SEL is configured for transmit and receive multicasting (see section D-9-2 on page 752).Anchor
Notes / Warnings
Anchor
NetDev_AddrMulticastAdd() to calculate the device’s CRC hash (see section BA-1-6 on page 362), but remove a multicast address by decrementing the device’s hash bit reference counters and clearing the appropriate bits in the device’s multicast registers.Anchor
...
| rowspan | 2 |
|---|
...
...
Listing A-3 Example device multicast address removal