File System Protocol
Version 1.02 12/12/00 199
10.2.6 EFI_FILE.SetPosition()
Summary
Sets a file’s current position.
Prototype
EFI_STATUS
(EFIAPI *EFI_FILE_SET_POSITION) (
IN EFI_FILE *This,
IN UINT64 Position
);
Parameters
This A pointer to the EFI_FILE instance that is the he file handle to set the
requested position on. Type EFI_FILE is defined in Section 10.2.
Position The byte position from the start of the file to set.
Description
The SetPosition() function sets the current file position for the handle to the position
supplied. With the exception of seeking to position –1, only absolute positioning is supported, and
seeking past the end of the file is allowed (a subsequent write would grow the file). Seeking to
position –1 causes the current position to be set to the end of the file.
If This is a directory, the only position that may be set is zero. This has the effect of starting the
read process of the directory entries over.
Status Codes Returned
EFI_SUCCESS The position was set.
EFI_UNSUPPORTED The seek request for non-zero is not valid on open
directories.