Efi_Pxe_Base_Code.setipfilter() - Intel Extensible Firmware Interface Specification

Extensible Firmware Interface Specification

14.1.8 EFI_PXE_BASE_CODE.SetIpFilter()

Summary
Updates the IP receive filters of a network device and enables software filtering.
Prototype
EFI_STATUS
(EFIAPI *EFI_PXE_BASE_CODE_SET_IP_FILTER) (
IN EFI_PXE_BASE_CODE
IN EFI_PXE_BASE_CODE_IP_FILTER
);
Parameters
This
NewFilter
Description
The field is used to modify the network device's current IP receive filter settings and
NewFilter
to enable a software filter. This function updates the
EFI_PXE_BASE_CODE_MODE
filter is used when the
filter remains in effect no matter what the settings of
set in
ANY_DEST_IP
enabled in hardware – physical NIC address (unicast), broadcast address, logical address or
addresses (multicast), or all (promiscuous).
Dhcp(), Discover(), and
emptied and the filter set to EFI_PXE_BASE_CODE_IP_FILTER_STATION_IP. If an
application or driver wishes to preserve the IP receive filter settings, it will have to preserve the IP
receive filter settings before these calls, and use
If incompatible filtering is requested (for example,
device does not support a requested filter setting and it cannot be accommodated in software (for
example,
PROMISCUOUS
field is used to enable IP's other than the StationIP. They may be multicast or
IPlist
unicast. If is set as well as EFI_PXE_BASE_CODE_IP_FILTER_STATION_IP, then
IPcnt
both the
StationIP
Status Codes Returned
EFI_SUCCESS
EFI_INVALID_PARAMETER
EFI_NOT_STARTED
266
Pointer to the
EFI_PXE_BASE_CODE
Pointer to the new set of IP receive filters.
structure with the contents of NewIpFilter. The software
in
USE_FILTER OpFlags
to
OpFlags UdpRead()
UdpRead()
set the IP filter, and return with the IP receive filter list
Mtftp()
SetIpFilter()
not supported),
EFI_INVALID_PARAMETER
and the IPs from the
IPlist
The IP receive filter settings were updated.
One of the parameters is not valid.
The PXE Base Code Protocol is not in the started state.
12/12/00
*This,
*NewFilter
instance.
field of the
IpFilter
is set to UdpRead(). The current hardware
are, so that the meaning of
OpFlags
is from those packets whose reception is
does not modify the IP filter settings.
to restore them after the calls.
with anything else) or if the
PROMISCUOUS
will be returned. The
will be used.
Version 1.02