summaryrefslogtreecommitdiff
path: root/MdePkg/Include/Ppi/BlockIo.h
diff options
context:
space:
mode:
authorlgao4 <lgao4@6f19259b-4bc3-4df7-8a09-765794883524>2006-07-20 09:08:37 +0000
committerlgao4 <lgao4@6f19259b-4bc3-4df7-8a09-765794883524>2006-07-20 09:08:37 +0000
commit0647c9adf92c6a8712091607a73b2768327a865d (patch)
tree41c00f087dea23a35388100f5b9895753555ac3c /MdePkg/Include/Ppi/BlockIo.h
parent151c1ccdcd6960c550fa491bd0ed467416bb2b74 (diff)
downloadedk2-platforms-0647c9adf92c6a8712091607a73b2768327a865d.tar.xz
Remove BugBug in comments and adjust function header according to code style doc.
git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@1055 6f19259b-4bc3-4df7-8a09-765794883524
Diffstat (limited to 'MdePkg/Include/Ppi/BlockIo.h')
-rw-r--r--MdePkg/Include/Ppi/BlockIo.h71
1 files changed, 28 insertions, 43 deletions
diff --git a/MdePkg/Include/Ppi/BlockIo.h b/MdePkg/Include/Ppi/BlockIo.h
index debcc0c8e4..4bb029ff43 100644
--- a/MdePkg/Include/Ppi/BlockIo.h
+++ b/MdePkg/Include/Ppi/BlockIo.h
@@ -48,10 +48,8 @@ typedef struct {
/**
Gets the count of block I/O devices that one specific block driver detects.
- @param PeiServices General-purpose services that are available to every PEIM.
-
- @param This Indicates the EFI_PEI_RECOVERY_BLOCK_IO_PPI instance.
-
+ @param PeiServices General-purpose services that are available to every PEIM.
+ @param This Indicates the EFI_PEI_RECOVERY_BLOCK_IO_PPI instance.
@param NumberBlockDevices The number of block I/O devices discovered.
@return Status code
@@ -68,21 +66,17 @@ EFI_STATUS
/**
Gets a block device¡¯s media information.
- @param PeiServices General-purpose services that are available to every PEIM
-
- @param This Indicates the EFI_PEI_RECOVERY_BLOCK_IO_PPI instance.
-
- @param DeviceIndex Specifies the block device to which the function
- wants to talk. Because the driver that implements Block I/O PPIs
- will manage multiple block devices, the PPIs that want to talk to a single
- device must specify the device index that was assigned during the enumeration
- process. This index is a number from one to NumberBlockDevices.
-
- @param MediaInfo The media information of the specified block media.
-
- @retval EFI_SUCCESS Media information about the specified block device was obtained successfully.
-
- @retval EFI_DEVICE_ERROR Cannot get the media information due to a hardware error.
+ @param PeiServices General-purpose services that are available to every PEIM
+ @param This Indicates the EFI_PEI_RECOVERY_BLOCK_IO_PPI instance.
+ @param DeviceIndex Specifies the block device to which the function
+ wants to talk. Because the driver that implements Block I/O PPIs
+ will manage multiple block devices, the PPIs that want to talk to a single
+ device must specify the device index that was assigned during the enumeration
+ process. This index is a number from one to NumberBlockDevices.
+ @param MediaInfo The media information of the specified block media.
+
+ @retval EFI_SUCCESS Media information about the specified block device was obtained successfully.
+ @retval EFI_DEVICE_ERROR Cannot get the media information due to a hardware error.
**/
typedef
@@ -97,31 +91,22 @@ EFI_STATUS
/**
Reads the requested number of blocks from the specified block device.
- @param PeiServices General-purpose services that are available to every PEIM.
-
- @param This Indicates the EFI_PEI_RECOVERY_BLOCK_IO_PPI instance.
-
- @param DeviceIndex Specifies the block device to which the function wants to talk.
-
- @param StartLBA The starting logical block address (LBA) to read from on the device
-
- @param BufferSize The size of the Buffer in bytes. This number must
- be a multiple of the intrinsic block size of the device.
-
- @param Buffer A pointer to the destination buffer for the data.
- The caller is responsible for the ownership of the buffer.
-
- @retval EFI_SUCCESS The data was read correctly from the device.
-
- @retval EFI_DEVICE_ERROR The device reported an error while attempting to perform the read operation.
-
+ @param PeiServices General-purpose services that are available to every PEIM.
+ @param This Indicates the EFI_PEI_RECOVERY_BLOCK_IO_PPI instance.
+ @param DeviceIndex Specifies the block device to which the function wants to talk.
+ @param StartLBA The starting logical block address (LBA) to read from on the device
+ @param BufferSize The size of the Buffer in bytes. This number must
+ be a multiple of the intrinsic block size of the device.
+ @param Buffer A pointer to the destination buffer for the data.
+ The caller is responsible for the ownership of the buffer.
+
+ @retval EFI_SUCCESS The data was read correctly from the device.
+ @retval EFI_DEVICE_ERROR The device reported an error while attempting to perform the read operation.
@retval EFI_INVALID_PARAMETER The read request contains LBAs that are not valid,
- or the buffer is not properly aligned.
-
- @retval EFI_BAD_BUFFER_SIZE The BufferSize parameter is not a multiple of
- the intrinsic block size of the device.
-
- @retval EFI_NO_MEDIA There is no media in the device.
+ or the buffer is not properly aligned.
+ @retval EFI_BAD_BUFFER_SIZE The BufferSize parameter is not a multiple of
+ the intrinsic block size of the device.
+ @retval EFI_NO_MEDIA There is no media in the device.
**/
typedef