G.4.19 Receive - Intel Extensible Firmware Interface Specification

Extensible Firmware Interface Specification
G.4.19 Receive
When the network adapter has received a frame, this command is used to copy the frame into
driver/application storage. Once a frame has been copied, it is removed from the receive queue.
G.4.19.1 Issuing the Command
To issue a Receive command, create a CDB and fill it in as shows in the table below:
CDB Field
OpCode
OpFlags
CPBsize
DBsize
CPBaddr
DBaddr
StatCode
StatFlags
IFnum
Control
Preparing the CPB
If multiple frames per command are supported (see
CPBs can be packed together. For each complete received frame, a receive buffer large enough to
contain the entire unfragmented frame needs to be described in the CPB.
#pragma pack(1)
typedef struct s_pxe_cpb_receive {
// Address of first byte of receive buffer.
// first byte of the frame header.
PXE_UINT64 BufferAddr;
// Length of receive buffer.
// the received frame (media header + data).
// smaller than the received frame, data will be lost.
PXE_UINT32 BufferLen;
// Reserved, must be set to zero.
PXE_UINT32 reserved;
} PXE_CPB_RECEIVE;
#pragma pack()
464
How to initialize the CDB structure for a Receive command
PXE_OPCODE_RECEIVE
Set as needed.
sizeof(PXE_CPB_RECEIVE)
sizeof(PXE_DB_RECEIVE)
Address of a
PXE_CPB_RECEIVE
Address of a
PXE_DB_RECEIVE
PXE_STATCODE_INITIALIZE
PXE_STATFLAGS_INITIALIZE
A valid interface number from zero to !PXE.IFcnt.
Set as needed.
!PXE.Implementation
This must be large enough to hold
12/12/00
structure.
structure.
flags), multiple
This is also the
If the length of
Version 1.02