Intel Extensible Firmware Interface, Specification

Page: 204 / 494

Extensible Firmware Interface Specification
186 12/12/00 Version 1.02
9.1.2 EFI_DISK_IO.WriteDisk()
Summary
Writes a specified number of bytes to a device.
Prototype
EFI_STATUS
(EFIAPI *EFI_DISK_WRITE) (
IN EFI_DISK_IO *This,
IN UINT32 MediaId,
IN UINT64 Offset,
IN UNITN BufferSize,
IN VOID *Buffer
);
Parameters
This
Indicates a pointer to the calling context. Type
EFI_DISK_IO
is
defined in Section 9.1.
MediaId
Id of the medium to be written.
Offset
The starting byte offset on the logical block I/O device to write.
BufferSize
The size in bytes of
Buffer
. The number of bytes to write to the
device.
Buffer
A pointer to the buffer containing the data to be written.
Description
The
WriteDisk()
function writes the number of bytes specified by
BufferSize
to the device.
All bytes are written, or an error is returned. If there is no medium in the device, the function
returns
EFI_NO_MEDIA
. If the
MediaId
is not the id of the medium currently in the device, the
function returns
EFI_MEDIA_CHANGED
.
Status Codes Returned
EFI_SUCCESS The data was written correctly to the device.
EFI_WRITE_PROTECTED The device cannot be written to.
EFI_NO_MEDIA There is no medium in the device.
EFI_MEDIA_CHANGED The
MediaId
is not for the current medium.
EFI_DEVICE_ERROR The device reported an error while performing the write operation.
EFI_INVALID_PARAMETER The write request contains device addresses that are not valid for the device.