G.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.
G.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)
Address of
CPBaddr
Address of
DBaddr
StatCode
PXE_STATCODE_INITIALIZE
StatFlags
PXE_STATFLAGS_INITIALIZE
A valid interface number from zero to !PXE.IFcnt.
IFnum
Control
Set as needed.
OpFlags
To read the current receive filter settings set the
•
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
Version 1.02
PXE_CPB_RECEIVE_FILTERS
PXE_DB_RECEIVE_FILTERS
CDB.OpFlags
12/12/00
32/64-bit UNDI Specification
structure.
structure.
field to:
439