Intel Extensible Firmware Interface, Specification

Page: 318 / 494

Extensible Firmware Interface Specification
300 12/12/00 Version 1.02
15.1.13 EFI_SIMPLE_NETWO RK.Receive()
Summary
Receives a packet from a network interface.
Prototype
EFI_STATUS
(EFIAPI *EFI_SIMPLE_NETWORK_RECEIVE) (
IN EFI_SIMPLE_NETWORK *This
OUT UINTN *HeaderSize OPTIONAL ,
IN OUT UINTN *BufferSize ,
OUT VOID *Buffer,
OUT EFI_MAC_ADDRESS *SrcAddr OPTIONAL ,
OUT EFI_MAC_ADDRESS *DestAddr OPTIONAL ,
OUT UINT16 *Protocol OPTIONAL
);
Parameters
This
A pointer to the
EFI_SIMPLE_NETWORK
instance.
HeaderSize
The size, in bytes, of the media header received on the network
interface. If this parameter is
NULL
, then the media header size
will not be returned.
BufferSize
On entry, the size, in bytes, of
Buffer
. On exit, the size, in
bytes, of the packet that was received on the network interface.
Buffer
A pointer to the data buffer to receive both the media header and
the data.
SrcAddr
The source HW MAC address. If this parameter is
NULL
, the
HW MAC source address will not be extracted from the media
header.
DestAddr
The destination HW MAC address. If this parameter is
NULL
,
the HW MAC destination address will not be extracted from the
media header.
Protocol
The media header type. If this parameter is
NULL
, then the
protocol will not be extracted from the media header. See
RFC 1700 section “Ether Types” for examples.