Efi_pxe_base_code.mtftp(), Mtftp() – Intel Extensible Firmware Interface User Manual

Page 656

Advertising
background image

Extensible Firmware Interface Specification

15-50

12/01/02

Version 1.10

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” below 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 get-file-size operations,

*BufferSize

returns the size of the

requested file. For read-file and write-file operations, this parameter is
set to the size of the buffer specified by the

BufferPtr

parameter. For

read-file operations, if

EFI_BUFFER_TOO_SMALL

is returned,

*BufferSize

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.

Advertising