Filter
Top Products
Extensible Firmware Interface Specification
E-66 12/01/02 Version 1.10
E.4.11 Receive Filters
This command is used to read and change receive filters and, if supported, read and change the
multicast MAC address filter list. Control will not be returned to the caller and the
COMMAND_COMPLETE status flag will not be set until the NIC is ready to receive.
E.4.11.1 Issuing the Command
To issue a Receive Filters command, create a CDB and fill it in as shows in the table below:
CDB Field How to initialize the CDB structure for a Receive Filters command
OpCode
PXE_OPCODE_RECEIVE_FILTERS
OpFlags Set as needed.
CPBsize
sizeof(PXE_CPB_RECEIVE_FILTERS)
DBsize
sizeof(PXE_DB_RECEIVE_FILTERS)
CPBaddr
Address of PXE_CPB_RECEIVE_FILTERS structure.
DBaddr
Address of PXE_DB_RECEIVE_FILTERS structure.
StatCode
PXE_STATCODE_INITIALIZE
StatFlags
PXE_STATFLAGS_INITIALIZE
IFnum
A valid interface number from zero to !PXE.IFcnt.
Control Set as needed.
OpFlags
To read the current receive filter settings set the CDB.OpFlags field to:
• PXE_OPFLAGS_RECEIVE_FILTER_READ
To change the current receive filter settings set one of these OpFlag bits:
• PXE_OPFLAGS_RECEIVE_FILTER_ENABLE
• PXE_OPFLAGS_RECEIVE_FILTER_DISABLE
When changing the receive filter settings, at least one of the OpFlag bits in this list must be
selected:
• PXE_OPFLAGS_RECEIVE_FILTER_UNICAST
• PXE_OPFLAGS_RECEIVE_FILTER_BROADCAST
• PXE_OPFLAGS_RECEIVE_FILTER_FILTERED_MULTICAST
• PXE_OPFLAGS_RECEIVE_FILTER_PROMISCUOUS
• PXE_OPFLAGS_RECEIVE_FILTER_ALL_MULTICAST
To clear the contents of the multicast MAC address filter list, set this OpFlag:
• PXE_OPFLAGS_RECEIVE_FILTER_RESET_MCAST_LIST