Description, Status codes returned – Intel Extensible Firmware Interface User Manual

Page 661

Advertising
background image

Protocols

— Network Support

Version 1.10

12/01/02

15-55

HeaderPtr

If

HeaderSize

is not

NULL

, a pointer to a header to be prepended to

the data at

BufferPtr

.

BufferSize

A pointer to the size of the data at

BufferPtr

.

BufferPtr

A pointer to the data to be written.

Description

This function writes a UDP packet specified by the (optional

HeaderPtr

and)

BufferPtr

parameters to the network interface. The UDP header is automatically built by this routine. It uses
the parameters

OpFlags

,

DestIp

,

DestPort

,

GatewayIp

,

SrcIp

, and

SrcPort

to build

this header. If the packet is successfully built and transmitted through the network interface, then

EFI_SUCCESS

will be returned. If a timeout occurs during the transmission of the packet, then

EFI_TIMEOUT

will be returned. If an ICMP error occurs during the transmission of the packet,

then the

IcmpErrorReceived

field is set to

TRUE

, the

IcmpError

field is filled in and

EFI_ICMP_ERROR

will be returned. If the Callback Protocol does not return

EFI_PXE_BASE_CODE_CALLBACK_STATUS_CONTINUE

, then

EFI_ABORTED

will be

returned.

Status Codes Returned

EFI_SUCCESS

The UDP Write operation was completed.

EFI_NOT_STARTED

The PXE Base Code Protocol is in the stopped state.

EFI_INVALID_PARAMETER

One of the parameters is not valid.

EFI_DEVICE_ERROR

The network device encountered an error during this operation.

EFI_BAD_BUFFER_SIZE

The buffer is too long to be transmitted.

EFI_ABORTED

The callback function aborted the UDP Write operation.

EFI_TIMEOUT

The UDP Write operation timed out.

EFI_ICMP_ERROR

The UDP Write operation generated an error.

Advertising