Intel Extensible Firmware Interface Specification page 277

MCastIp
CPort
SPort
ListenTimeout
TransmitTimeout
Description
This function is used to perform TFTP and MTFTP services. This includes the TFTP operations to
get the size of a file, read a directory, read a file, and write a file. It also includes the MTFTP
operations to get the size of a file, read a directory, and read a file. The type of operation is
specified by Operation. If the callback function that is invoked during the TFTP/MTFTP
operation does not return EFI_PXE_BASE_CODE_CALLBACK_STATUS_CONTINUE, then
will be returned.
EFI_ABORTED
For read operations, the return data will be placed in the buffer specified by BufferPtr. If
is too small to contain the entire downloaded file, then
BufferSize
EFI_BUFFER_TOO_SMALL
the requested file (the size of the requested file is only returned if the TFTP server supports TFTP
options). If
BufferSize
the size of the downloaded file, and
For write operations, the data to be sent is in the buffer specified by BufferPtr.
specifies the number of bytes to send. If the write operation completes successfully, then
will be returned.
EFI_SUCCESS
For TFTP "get file size" operations, the size of the requested file or directory is returned in
BufferSize, and
EFI_SUCCESS
the file will be downloaded into a bit bucket and the length of the downloaded file will be returned.
For MTFTP "get file size" operations, if the MTFTP server does not support the "get file size"
option,
EFI_UNSUPPORTED
This function can take up to 10 seconds to timeout and return control to the caller. If the TFTP
sequence does not complete,
If the Callback Protocol does not return
EFI_PXE_BASE_CODE_CALLBACK_STATUS_CONTINUE, then the TFTP sequence is stopped
and will be returned.
EFI_ABORTED
Version 1.02
File multicast IP address. This is the IP address to which the
server will send the requested file.
Client multicast listening port. This is the UDP port to which the
server will send the requested file.
Server multicast listening port. This is the UDP port on which
the server listens for multicast open requests and data acks.
The number of seconds a client should listen for an active
multicast session before requesting a new multicast session.
The number of seconds a client should wait for a packet from the
server before retransmitting the previous open request or data
ack packet.
will be returned and
BufferSize
is large enough for the read operation, then
will be returned.
EFI_SUCCESS
will be returned. If the TFTP server does not support options,
will be returned.
will be returned.
EFI_TIMEOUT
12/12/00
PXE Base Code Protocol
will be set to zero or the size of
will be set to
BufferSize
BufferSize
259