Intel Extensible Firmware Interface, Specification

Page: 275 / 494

PXE Base Code Protocol
Version 1.02 12/12/00 257
14.1.5 EFI_PXE_BASE_CODE.Mtftp()
Summary
Used to perform TFTP and MTFTP services.
Prototype
EFI_STATUS
(EFIAPI *EFI_PXE_BASE_CODE_MTFTP) (
IN EFI_PXE_BASE_CODE *This,
IN EFI_PXE_BASE_CODE_TFTP_OPCODE Operation,
IN OUT VOID *BufferPtr, OPTIONAL
IN BOOLEAN Overwrite,
IN OUT UINTN *BufferSize,
IN UINTN *BlockSize, OPTIONAL
IN EFI_IP_ADDRESS *ServerIp,
IN CHAR8 *Filename, OPTIONAL
IN EFI_PXE_BASE_CODE_MTFTP_INFO *Info, OPTIONAL
IN BOOLEAN DontUseBuffer
);
Parameters
This
Pointer to the
EFI_PXE_BASE_CODE
instance.
Operation
The type of operation to perform. See "Related Definitions" for the list
of operation types.
BufferPtr
A pointer to the data buffer. Ignored for read file if
DontUseBuffer
is
TRUE
.
Overwrite
Only used on write file operations.
TRUE
if a file on a remote server can
be overwritten.
BufferSize
For read-file and write-file operations, this is the size of the buffer
specified by
BufferPtr
. For read file operations, if
BufferSize
is
smaller than the size of the file being read, then this field will return the
required size. For get-file size operations, this field returns the size of
the requested file.
BlockSize
The requested block size to be used during a TFTP transfer. This must
be at least 512. If this field is
NULL
, then the largest block size
supported by the implementation will be used.
ServerIp
The TFTP / MTFTP server IP address.
Filename
A Null-terminated ASCII string that specifies a directory name or a file
name. This is ignored by MTFTP read directory.