[mirror_edk2.git] / IntelFrameworkModulePkg / Csm / BiosThunk / BlockIoDxe / BiosBlkIo.h

/** @file\r
\r
Copyright (c) 1999 - 2018, Intel Corporation. All rights reserved.<BR>\r
\r
SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
**/\r
\r
#ifndef _BIOS_BLOCK_IO_H_\r
#define _BIOS_BLOCK_IO_H_\r
\r
#include <Uefi.h>\r
\r
#include <Protocol/BlockIo.h>\r
#include <Protocol/PciIo.h>\r
#include <Protocol/LegacyBios.h>\r
#include <Protocol/DevicePath.h>\r
#include <Guid/LegacyBios.h>\r
#include <Guid/BlockIoVendor.h>\r
\r
#include <Library/UefiDriverEntryPoint.h>\r
#include <Library/DebugLib.h>\r
#include <Library/BaseMemoryLib.h>\r
#include <Library/UefiBootServicesTableLib.h>\r
#include <Library/UefiLib.h>\r
#include <Library/DevicePathLib.h>\r
#include <Library/MemoryAllocationLib.h>\r
\r
#include <IndustryStandard/Pci.h>\r
\r
#include "Edd.h"\r
\r
//\r
// Global Variables\r
//\r
extern EFI_COMPONENT_NAME_PROTOCOL   gBiosBlockIoComponentName;\r
extern EFI_COMPONENT_NAME2_PROTOCOL  gBiosBlockIoComponentName2;\r
\r
\r
//\r
// Define the I2O class code\r
//\r
#define PCI_BASE_CLASS_INTELLIGENT  0x0e\r
#define PCI_SUB_CLASS_INTELLIGENT   0x00\r
\r
//\r
// Number of pages needed for our buffer under 1MB\r
//\r
#define BLOCK_IO_BUFFER_PAGE_SIZE (((sizeof (EDD_DEVICE_ADDRESS_PACKET) + sizeof (BIOS_LEGACY_DRIVE) + MAX_EDD11_XFER) / EFI_PAGE_SIZE) + 1 \\r
        )\r
\r
//\r
// Driver Binding Protocol functions\r
//\r
\r
/**\r
  Check whether the driver supports this device.\r
\r
  @param  This                   The Udriver binding protocol.\r
  @param  Controller             The controller handle to check.\r
  @param  RemainingDevicePath    The remaining device path.\r
\r
  @retval EFI_SUCCESS            The driver supports this controller.\r
  @retval other                  This device isn't supported.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
BiosBlockIoDriverBindingSupported (\r
  IN EFI_DRIVER_BINDING_PROTOCOL  *This,\r
  IN EFI_HANDLE                   Controller,\r
  IN EFI_DEVICE_PATH_PROTOCOL     *RemainingDevicePath\r
  );\r
\r
\r
/**\r
  Starts the device with this driver.\r
\r
  @param  This                   The driver binding instance.\r
  @param  Controller             Handle of device to bind driver to.\r
  @param  RemainingDevicePath    Optional parameter use to pick a specific child\r
                                 device to start.\r
\r
  @retval EFI_SUCCESS            The controller is controlled by the driver.\r
  @retval Other                  This controller cannot be started.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
BiosBlockIoDriverBindingStart (\r
  IN EFI_DRIVER_BINDING_PROTOCOL  *This,\r
  IN EFI_HANDLE                   Controller,\r
  IN EFI_DEVICE_PATH_PROTOCOL     *RemainingDevicePath\r
  );\r
\r
/**\r
  Stop the device handled by this driver.\r
\r
  @param  This                   The driver binding protocol.\r
  @param  Controller             The controller to release.\r
  @param  NumberOfChildren       The number of handles in ChildHandleBuffer.\r
  @param  ChildHandleBuffer      The array of child handle.\r
\r
  @retval EFI_SUCCESS            The device was stopped.\r
  @retval EFI_DEVICE_ERROR       The device could not be stopped due to a device error.\r
  @retval Others                 Fail to uninstall protocols attached on the device.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
BiosBlockIoDriverBindingStop (\r
  IN  EFI_DRIVER_BINDING_PROTOCOL  *This,\r
  IN  EFI_HANDLE                   Controller,\r
  IN  UINTN                        NumberOfChildren,\r
  IN  EFI_HANDLE                   *ChildHandleBuffer\r
  );\r
\r
//\r
// Other internal functions\r
//\r
\r
/**\r
  Build device path for EDD 3.0.\r
\r
  @param  BaseDevicePath         Base device path.\r
  @param  Drive                  Legacy drive.\r
  @param  DevicePath             Device path for output.\r
\r
  @retval EFI_SUCCESS            The device path is built successfully.\r
  @retval EFI_UNSUPPORTED        It is failed to built device path.\r
\r
**/\r
EFI_STATUS\r
BuildEdd30DevicePath (\r
  IN  EFI_DEVICE_PATH_PROTOCOL  *BaseDevicePath,\r
  IN  BIOS_LEGACY_DRIVE         *Drive,\r
  IN  EFI_DEVICE_PATH_PROTOCOL  **DevicePath\r
  );\r
\r
/**\r
  Initialize block I/O device instance\r
\r
  @param  Dev   Instance of block I/O device instance\r
\r
  @retval TRUE  Initialization succeeds.\r
  @retval FALSE Initialization fails.\r
\r
**/\r
BOOLEAN\r
BiosInitBlockIo (\r
  IN  BIOS_BLOCK_IO_DEV     *Dev\r
  );\r
\r
/**\r
  Read BufferSize bytes from Lba into Buffer.\r
\r
  @param  This       Indicates a pointer to the calling context.\r
  @param  MediaId    Id of the media, changes every time the media is replaced.\r
  @param  Lba        The starting Logical Block Address to read from\r
  @param  BufferSize Size of Buffer, must be a multiple of device block size.\r
  @param  Buffer     A pointer to the destination buffer for the data. The caller is\r
                     responsible for either having implicit or explicit ownership of the buffer.\r
\r
  @retval EFI_SUCCESS           The data was read correctly from the device.\r
  @retval EFI_DEVICE_ERROR      The device reported an error while performing the read.\r
  @retval EFI_NO_MEDIA          There is no media in the device.\r
  @retval EFI_MEDIA_CHANGED     The MediaId does not matched the current device.\r
  @retval EFI_BAD_BUFFER_SIZE   The Buffer was not a multiple of the block size of the device.\r
  @retval EFI_INVALID_PARAMETER The read request contains LBAs that are not valid,\r
                                or the buffer is not on proper alignment.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
Edd30BiosReadBlocks (\r
  IN  EFI_BLOCK_IO_PROTOCOL *This,\r
  IN  UINT32                MediaId,\r
  IN  EFI_LBA               Lba,\r
  IN  UINTN                 BufferSize,\r
  OUT VOID                  *Buffer\r
  );\r
\r
/**\r
  Write BufferSize bytes from Lba into Buffer.\r
\r
  @param  This       Indicates a pointer to the calling context.\r
  @param  MediaId    The media ID that the write request is for.\r
  @param  Lba        The starting logical block address to be written. The caller is\r
                     responsible for writing to only legitimate locations.\r
  @param  BufferSize Size of Buffer, must be a multiple of device block size.\r
  @param  Buffer     A pointer to the source buffer for the data.\r
\r
  @retval EFI_SUCCESS           The data was written correctly to the device.\r
  @retval EFI_WRITE_PROTECTED   The device can not be written to.\r
  @retval EFI_DEVICE_ERROR      The device reported an error while performing the write.\r
  @retval EFI_NO_MEDIA          There is no media in the device.\r
  @retval EFI_MEDIA_CHNAGED     The MediaId does not matched the current device.\r
  @retval EFI_BAD_BUFFER_SIZE   The Buffer was not a multiple of the block size of the device.\r
  @retval EFI_INVALID_PARAMETER The write request contains LBAs that are not valid,\r
                                or the buffer is not on proper alignment.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
Edd30BiosWriteBlocks (\r
  IN  EFI_BLOCK_IO_PROTOCOL  *This,\r
  IN  UINT32                 MediaId,\r
  IN  EFI_LBA                Lba,\r
  IN  UINTN                  BufferSize,\r
  OUT VOID                   *Buffer\r
  );\r
\r
/**\r
  Flush the Block Device.\r
\r
  @param  This              Indicates a pointer to the calling context.\r
\r
  @retval EFI_SUCCESS       All outstanding data was written to the device\r
  @retval EFI_DEVICE_ERROR  The device reported an error while writting back the data\r
  @retval EFI_NO_MEDIA      There is no media in the device.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
BiosBlockIoFlushBlocks (\r
  IN  EFI_BLOCK_IO_PROTOCOL  *This\r
  );\r
\r
/**\r
  Reset the Block Device.\r
\r
  @param  This                 Indicates a pointer to the calling context.\r
  @param  ExtendedVerification Driver may perform diagnostics on reset.\r
\r
  @retval EFI_SUCCESS          The device was reset.\r
  @retval EFI_DEVICE_ERROR     The device is not functioning properly and could\r
                               not be reset.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
BiosBlockIoReset (\r
  IN  EFI_BLOCK_IO_PROTOCOL  *This,\r
  IN  BOOLEAN                ExtendedVerification\r
  );\r
\r
/**\r
  Read BufferSize bytes from Lba into Buffer.\r
\r
  @param  This       Indicates a pointer to the calling context.\r
  @param  MediaId    Id of the media, changes every time the media is replaced.\r
  @param  Lba        The starting Logical Block Address to read from\r
  @param  BufferSize Size of Buffer, must be a multiple of device block size.\r
  @param  Buffer     A pointer to the destination buffer for the data. The caller is\r
                     responsible for either having implicit or explicit ownership of the buffer.\r
\r
  @retval EFI_SUCCESS           The data was read correctly from the device.\r
  @retval EFI_DEVICE_ERROR      The device reported an error while performing the read.\r
  @retval EFI_NO_MEDIA          There is no media in the device.\r
  @retval EFI_MEDIA_CHANGED     The MediaId does not matched the current device.\r
  @retval EFI_BAD_BUFFER_SIZE   The Buffer was not a multiple of the block size of the device.\r
  @retval EFI_INVALID_PARAMETER The read request contains LBAs that are not valid,\r
                                or the buffer is not on proper alignment.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
Edd11BiosReadBlocks (\r
  IN  EFI_BLOCK_IO_PROTOCOL *This,\r
  IN  UINT32                MediaId,\r
  IN  EFI_LBA               Lba,\r
  IN  UINTN                 BufferSize,\r
  OUT VOID                  *Buffer\r
  );\r
\r
/**\r
  Write BufferSize bytes from Lba into Buffer.\r
\r
  @param  This       Indicates a pointer to the calling context.\r
  @param  MediaId    The media ID that the write request is for.\r
  @param  Lba        The starting logical block address to be written. The caller is\r
                     responsible for writing to only legitimate locations.\r
  @param  BufferSize Size of Buffer, must be a multiple of device block size.\r
  @param  Buffer     A pointer to the source buffer for the data.\r
\r
  @retval EFI_SUCCESS           The data was written correctly to the device.\r
  @retval EFI_WRITE_PROTECTED   The device can not be written to.\r
  @retval EFI_DEVICE_ERROR      The device reported an error while performing the write.\r
  @retval EFI_NO_MEDIA          There is no media in the device.\r
  @retval EFI_MEDIA_CHNAGED     The MediaId does not matched the current device.\r
  @retval EFI_BAD_BUFFER_SIZE   The Buffer was not a multiple of the block size of the device.\r
  @retval EFI_INVALID_PARAMETER The write request contains LBAs that are not valid,\r
                                or the buffer is not on proper alignment.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
Edd11BiosWriteBlocks (\r
  IN  EFI_BLOCK_IO_PROTOCOL *This,\r
  IN  UINT32                MediaId,\r
  IN  EFI_LBA               Lba,\r
  IN  UINTN                 BufferSize,\r
  OUT VOID                  *Buffer\r
  );\r
\r
/**\r
  Read BufferSize bytes from Lba into Buffer.\r
\r
  @param  This       Indicates a pointer to the calling context.\r
  @param  MediaId    Id of the media, changes every time the media is replaced.\r
  @param  Lba        The starting Logical Block Address to read from\r
  @param  BufferSize Size of Buffer, must be a multiple of device block size.\r
  @param  Buffer     A pointer to the destination buffer for the data. The caller is\r
                     responsible for either having implicit or explicit ownership of the buffer.\r
\r
  @retval EFI_SUCCESS           The data was read correctly from the device.\r
  @retval EFI_DEVICE_ERROR      The device reported an error while performing the read.\r
  @retval EFI_NO_MEDIA          There is no media in the device.\r
  @retval EFI_MEDIA_CHANGED     The MediaId does not matched the current device.\r
  @retval EFI_BAD_BUFFER_SIZE   The Buffer was not a multiple of the block size of the device.\r
  @retval EFI_INVALID_PARAMETER The read request contains LBAs that are not valid,\r
                                or the buffer is not on proper alignment.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
BiosReadLegacyDrive (\r
  IN  EFI_BLOCK_IO_PROTOCOL *This,\r
  IN  UINT32                MediaId,\r
  IN  EFI_LBA               Lba,\r
  IN  UINTN                 BufferSize,\r
  OUT VOID                  *Buffer\r
  );\r
\r
/**\r
  Write BufferSize bytes from Lba into Buffer.\r
\r
  @param  This       Indicates a pointer to the calling context.\r
  @param  MediaId    The media ID that the write request is for.\r
  @param  Lba        The starting logical block address to be written. The caller is\r
                     responsible for writing to only legitimate locations.\r
  @param  BufferSize Size of Buffer, must be a multiple of device block size.\r
  @param  Buffer     A pointer to the source buffer for the data.\r
\r
  @retval EFI_SUCCESS           The data was written correctly to the device.\r
  @retval EFI_WRITE_PROTECTED   The device can not be written to.\r
  @retval EFI_DEVICE_ERROR      The device reported an error while performing the write.\r
  @retval EFI_NO_MEDIA          There is no media in the device.\r
  @retval EFI_MEDIA_CHNAGED     The MediaId does not matched the current device.\r
  @retval EFI_BAD_BUFFER_SIZE   The Buffer was not a multiple of the block size of the device.\r
  @retval EFI_INVALID_PARAMETER The write request contains LBAs that are not valid,\r
                                or the buffer is not on proper alignment.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
BiosWriteLegacyDrive (\r
  IN  EFI_BLOCK_IO_PROTOCOL *This,\r
  IN  UINT32                MediaId,\r
  IN  EFI_LBA               Lba,\r
  IN  UINTN                 BufferSize,\r
  OUT VOID                  *Buffer\r
  );\r
\r
/**\r
  Gets parameters of block I/O device.\r
\r
  @param  BiosBlockIoDev Instance of block I/O device.\r
  @param  Drive          Legacy drive.\r
\r
  @return  Result of device parameter retrieval.\r
\r
**/\r
UINTN\r
Int13GetDeviceParameters (\r
  IN BIOS_BLOCK_IO_DEV    *BiosBlockIoDev,\r
  IN BIOS_LEGACY_DRIVE    *Drive\r
  );\r
\r
/**\r
  Extension of INT13 call.\r
\r
  @param  BiosBlockIoDev Instance of block I/O device.\r
  @param  Drive          Legacy drive.\r
\r
  @return  Result of this extension.\r
\r
**/\r
UINTN\r
Int13Extensions (\r
  IN BIOS_BLOCK_IO_DEV    *BiosBlockIoDev,\r
  IN BIOS_LEGACY_DRIVE    *Drive\r
  );\r
\r
/**\r
  Gets parameters of legacy drive.\r
\r
  @param  BiosBlockIoDev Instance of block I/O device.\r
  @param  Drive          Legacy drive.\r
\r
  @return  Result of drive parameter retrieval.\r
\r
**/\r
UINTN\r
GetDriveParameters (\r
  IN BIOS_BLOCK_IO_DEV    *BiosBlockIoDev,\r
  IN  BIOS_LEGACY_DRIVE   *Drive\r
  );\r
\r
/**\r
  Build device path for device.\r
\r
  @param  BaseDevicePath         Base device path.\r
  @param  Drive                  Legacy drive.\r
  @param  DevicePath             Device path for output.\r
\r
**/\r
VOID\r
SetBiosInitBlockIoDevicePath (\r
  IN  EFI_DEVICE_PATH_PROTOCOL  *BaseDevicePath,\r
  IN  BIOS_LEGACY_DRIVE         *Drive,\r
  OUT EFI_DEVICE_PATH_PROTOCOL  **DevicePath\r
  );\r
\r
#endif\r
Commit	Line	Data
bcecde14	1	/** @file\r
bcecde14	2	\r
0a6f4824	3	Copyright (c) 1999 - 2018, Intel Corporation. All rights reserved.<BR>\r
bcecde14	4	\r
c0a00b14	5	SPDX-License-Identifier: BSD-2-Clause-Patent\r
bcecde14	6	\r
	7	**/\r
	8	\r
	9	#ifndef _BIOS_BLOCK_IO_H_\r
	10	#define _BIOS_BLOCK_IO_H_\r
	11	\r
	12	#include <Uefi.h>\r
	13	\r
	14	#include <Protocol/BlockIo.h>\r
	15	#include <Protocol/PciIo.h>\r
	16	#include <Protocol/LegacyBios.h>\r
	17	#include <Protocol/DevicePath.h>\r
	18	#include <Guid/LegacyBios.h>\r
e24fc103	19	#include <Guid/BlockIoVendor.h>\r
bcecde14	20	\r
	21	#include <Library/UefiDriverEntryPoint.h>\r
	22	#include <Library/DebugLib.h>\r
	23	#include <Library/BaseMemoryLib.h>\r
	24	#include <Library/UefiBootServicesTableLib.h>\r
	25	#include <Library/UefiLib.h>\r
	26	#include <Library/DevicePathLib.h>\r
	27	#include <Library/MemoryAllocationLib.h>\r
	28	\r
	29	#include <IndustryStandard/Pci.h>\r
	30	\r
	31	#include "Edd.h"\r
	32	\r
bcecde14	33	//\r
	34	// Global Variables\r
	35	//\r
	36	extern EFI_COMPONENT_NAME_PROTOCOL gBiosBlockIoComponentName;\r
	37	extern EFI_COMPONENT_NAME2_PROTOCOL gBiosBlockIoComponentName2;\r
	38	\r
	39	\r
	40	//\r
	41	// Define the I2O class code\r
	42	//\r
	43	#define PCI_BASE_CLASS_INTELLIGENT 0x0e\r
	44	#define PCI_SUB_CLASS_INTELLIGENT 0x00\r
	45	\r
	46	//\r
	47	// Number of pages needed for our buffer under 1MB\r
	48	//\r
	49	#define BLOCK_IO_BUFFER_PAGE_SIZE (((sizeof (EDD_DEVICE_ADDRESS_PACKET) + sizeof (BIOS_LEGACY_DRIVE) + MAX_EDD11_XFER) / EFI_PAGE_SIZE) + 1 \\r
	50	)\r
	51	\r
	52	//\r
	53	// Driver Binding Protocol functions\r
	54	//\r
	55	\r
	56	/**\r
	57	Check whether the driver supports this device.\r
	58	\r
	59	@param This The Udriver binding protocol.\r
	60	@param Controller The controller handle to check.\r
	61	@param RemainingDevicePath The remaining device path.\r
	62	\r
	63	@retval EFI_SUCCESS The driver supports this controller.\r
	64	@retval other This device isn't supported.\r
	65	\r
	66	**/\r
	67	EFI_STATUS\r
	68	EFIAPI\r
	69	BiosBlockIoDriverBindingSupported (\r
	70	IN EFI_DRIVER_BINDING_PROTOCOL *This,\r
	71	IN EFI_HANDLE Controller,\r
	72	IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath\r
	73	);\r
	74	\r
	75	\r
	76	/**\r
	77	Starts the device with this driver.\r
	78	\r
	79	@param This The driver binding instance.\r
	80	@param Controller Handle of device to bind driver to.\r
	81	@param RemainingDevicePath Optional parameter use to pick a specific child\r
	82	device to start.\r
	83	\r
	84	@retval EFI_SUCCESS The controller is controlled by the driver.\r
	85	@retval Other This controller cannot be started.\r
	86	\r
	87	**/\r
	88	EFI_STATUS\r
	89	EFIAPI\r
	90	BiosBlockIoDriverBindingStart (\r
	91	IN EFI_DRIVER_BINDING_PROTOCOL *This,\r
	92	IN EFI_HANDLE Controller,\r
	93	IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath\r
	94	);\r
	95	\r
	96	/**\r
97	Stop the device handled by this driver.\r
98	\r
99	@param This The driver binding protocol.\r
100	@param Controller The controller to release.\r
101	@param NumberOfChildren The number of handles in ChildHandleBuffer.\r
102	@param ChildHandleBuffer The array of child handle.\r
103	\r
104	@retval EFI_SUCCESS The device was stopped.\r
105	@retval EFI_DEVICE_ERROR The device could not be stopped due to a device error.\r
106	@retval Others Fail to uninstall protocols attached on the device.\r
107	\r
108	**/\r
109	EFI_STATUS\r
110	EFIAPI\r
111	BiosBlockIoDriverBindingStop (\r
112	IN EFI_DRIVER_BINDING_PROTOCOL *This,\r
113	IN EFI_HANDLE Controller,\r
114	IN UINTN NumberOfChildren,\r
115	IN EFI_HANDLE *ChildHandleBuffer\r
116	);\r
117	\r
118	//\r
119	// Other internal functions\r
120	//\r
121	\r
122	/**\r
123	Build device path for EDD 3.0.\r
124	\r
125	@param BaseDevicePath Base device path.\r
126	@param Drive Legacy drive.\r
127	@param DevicePath Device path for output.\r
128	\r
129	@retval EFI_SUCCESS The device path is built successfully.\r
130	@retval EFI_UNSUPPORTED It is failed to built device path.\r
131	\r
132	**/\r
133	EFI_STATUS\r
134	BuildEdd30DevicePath (\r
135	IN EFI_DEVICE_PATH_PROTOCOL *BaseDevicePath,\r
136	IN BIOS_LEGACY_DRIVE *Drive,\r
137	IN EFI_DEVICE_PATH_PROTOCOL **DevicePath\r
138	);\r
139	\r
140	/**\r
141	Initialize block I/O device instance\r
142	\r
143	@param Dev Instance of block I/O device instance\r
144	\r
145	@retval TRUE Initialization succeeds.\r
146	@retval FALSE Initialization fails.\r
147	\r
148	**/\r
149	BOOLEAN\r
150	BiosInitBlockIo (\r
151	IN BIOS_BLOCK_IO_DEV *Dev\r
152	);\r
153	\r
154	/**\r
155	Read BufferSize bytes from Lba into Buffer.\r
156	\r
157	@param This Indicates a pointer to the calling context.\r
158	@param MediaId Id of the media, changes every time the media is replaced.\r
159	@param Lba The starting Logical Block Address to read from\r
160	@param BufferSize Size of Buffer, must be a multiple of device block size.\r
161	@param Buffer A pointer to the destination buffer for the data. The caller is\r
162	responsible for either having implicit or explicit ownership of the buffer.\r
163	\r
164	@retval EFI_SUCCESS The data was read correctly from the device.\r
165	@retval EFI_DEVICE_ERROR The device reported an error while performing the read.\r
166	@retval EFI_NO_MEDIA There is no media in the device.\r
167	@retval EFI_MEDIA_CHANGED The MediaId does not matched the current device.\r
168	@retval EFI_BAD_BUFFER_SIZE The Buffer was not a multiple of the block size of the device.\r
0a6f4824	169	@retval EFI_INVALID_PARAMETER The read request contains LBAs that are not valid,\r
bcecde14	170	or the buffer is not on proper alignment.\r
	171	\r
	172	**/\r
	173	EFI_STATUS\r
	174	EFIAPI\r
	175	Edd30BiosReadBlocks (\r
	176	IN EFI_BLOCK_IO_PROTOCOL *This,\r
	177	IN UINT32 MediaId,\r
	178	IN EFI_LBA Lba,\r
	179	IN UINTN BufferSize,\r
	180	OUT VOID *Buffer\r
	181	);\r
	182	\r
	183	/**\r
	184	Write BufferSize bytes from Lba into Buffer.\r
	185	\r
	186	@param This Indicates a pointer to the calling context.\r
	187	@param MediaId The media ID that the write request is for.\r
	188	@param Lba The starting logical block address to be written. The caller is\r
	189	responsible for writing to only legitimate locations.\r
	190	@param BufferSize Size of Buffer, must be a multiple of device block size.\r
	191	@param Buffer A pointer to the source buffer for the data.\r
	192	\r
	193	@retval EFI_SUCCESS The data was written correctly to the device.\r
	194	@retval EFI_WRITE_PROTECTED The device can not be written to.\r
	195	@retval EFI_DEVICE_ERROR The device reported an error while performing the write.\r
	196	@retval EFI_NO_MEDIA There is no media in the device.\r
	197	@retval EFI_MEDIA_CHNAGED The MediaId does not matched the current device.\r
	198	@retval EFI_BAD_BUFFER_SIZE The Buffer was not a multiple of the block size of the device.\r
0a6f4824	199	@retval EFI_INVALID_PARAMETER The write request contains LBAs that are not valid,\r
bcecde14	200	or the buffer is not on proper alignment.\r
	201	\r
	202	**/\r
	203	EFI_STATUS\r
	204	EFIAPI\r
	205	Edd30BiosWriteBlocks (\r
	206	IN EFI_BLOCK_IO_PROTOCOL *This,\r
	207	IN UINT32 MediaId,\r
	208	IN EFI_LBA Lba,\r
	209	IN UINTN BufferSize,\r
	210	OUT VOID *Buffer\r
	211	);\r
	212	\r
	213	/**\r
	214	Flush the Block Device.\r
	215	\r
	216	@param This Indicates a pointer to the calling context.\r
	217	\r
	218	@retval EFI_SUCCESS All outstanding data was written to the device\r
	219	@retval EFI_DEVICE_ERROR The device reported an error while writting back the data\r
	220	@retval EFI_NO_MEDIA There is no media in the device.\r
	221	\r
	222	**/\r
	223	EFI_STATUS\r
	224	EFIAPI\r
	225	BiosBlockIoFlushBlocks (\r
	226	IN EFI_BLOCK_IO_PROTOCOL *This\r
	227	);\r
	228	\r
	229	/**\r
	230	Reset the Block Device.\r
	231	\r
	232	@param This Indicates a pointer to the calling context.\r
	233	@param ExtendedVerification Driver may perform diagnostics on reset.\r
	234	\r
	235	@retval EFI_SUCCESS The device was reset.\r
	236	@retval EFI_DEVICE_ERROR The device is not functioning properly and could\r
	237	not be reset.\r
	238	\r
	239	**/\r
	240	EFI_STATUS\r
	241	EFIAPI\r
	242	BiosBlockIoReset (\r
	243	IN EFI_BLOCK_IO_PROTOCOL *This,\r
	244	IN BOOLEAN ExtendedVerification\r
	245	);\r
	246	\r
	247	/**\r
	248	Read BufferSize bytes from Lba into Buffer.\r
	249	\r
	250	@param This Indicates a pointer to the calling context.\r
	251	@param MediaId Id of the media, changes every time the media is replaced.\r
	252	@param Lba The starting Logical Block Address to read from\r
	253	@param BufferSize Size of Buffer, must be a multiple of device block size.\r
	254	@param Buffer A pointer to the destination buffer for the data. The caller is\r
	255	responsible for either having implicit or explicit ownership of the buffer.\r
	256	\r
	257	@retval EFI_SUCCESS The data was read correctly from the device.\r
	258	@retval EFI_DEVICE_ERROR The device reported an error while performing the read.\r
	259	@retval EFI_NO_MEDIA There is no media in the device.\r
	260	@retval EFI_MEDIA_CHANGED The MediaId does not matched the current device.\r
	261	@retval EFI_BAD_BUFFER_SIZE The Buffer was not a multiple of the block size of the device.\r
0a6f4824	262	@retval EFI_INVALID_PARAMETER The read request contains LBAs that are not valid,\r
bcecde14	263	or the buffer is not on proper alignment.\r
	264	\r
	265	**/\r
	266	EFI_STATUS\r
	267	EFIAPI\r
	268	Edd11BiosReadBlocks (\r
	269	IN EFI_BLOCK_IO_PROTOCOL *This,\r
	270	IN UINT32 MediaId,\r
	271	IN EFI_LBA Lba,\r
	272	IN UINTN BufferSize,\r
	273	OUT VOID *Buffer\r
	274	);\r
	275	\r
	276	/**\r
	277	Write BufferSize bytes from Lba into Buffer.\r
	278	\r
	279	@param This Indicates a pointer to the calling context.\r
	280	@param MediaId The media ID that the write request is for.\r
	281	@param Lba The starting logical block address to be written. The caller is\r
	282	responsible for writing to only legitimate locations.\r
	283	@param BufferSize Size of Buffer, must be a multiple of device block size.\r
	284	@param Buffer A pointer to the source buffer for the data.\r
	285	\r
	286	@retval EFI_SUCCESS The data was written correctly to the device.\r
	287	@retval EFI_WRITE_PROTECTED The device can not be written to.\r
	288	@retval EFI_DEVICE_ERROR The device reported an error while performing the write.\r
	289	@retval EFI_NO_MEDIA There is no media in the device.\r
	290	@retval EFI_MEDIA_CHNAGED The MediaId does not matched the current device.\r
	291	@retval EFI_BAD_BUFFER_SIZE The Buffer was not a multiple of the block size of the device.\r
0a6f4824	292	@retval EFI_INVALID_PARAMETER The write request contains LBAs that are not valid,\r
bcecde14	293	or the buffer is not on proper alignment.\r
	294	\r
	295	**/\r
	296	EFI_STATUS\r
	297	EFIAPI\r
	298	Edd11BiosWriteBlocks (\r
	299	IN EFI_BLOCK_IO_PROTOCOL *This,\r
	300	IN UINT32 MediaId,\r
	301	IN EFI_LBA Lba,\r
	302	IN UINTN BufferSize,\r
	303	OUT VOID *Buffer\r
	304	);\r
	305	\r
	306	/**\r
	307	Read BufferSize bytes from Lba into Buffer.\r
	308	\r
	309	@param This Indicates a pointer to the calling context.\r
	310	@param MediaId Id of the media, changes every time the media is replaced.\r
	311	@param Lba The starting Logical Block Address to read from\r
	312	@param BufferSize Size of Buffer, must be a multiple of device block size.\r
	313	@param Buffer A pointer to the destination buffer for the data. The caller is\r
	314	responsible for either having implicit or explicit ownership of the buffer.\r
	315	\r
	316	@retval EFI_SUCCESS The data was read correctly from the device.\r
	317	@retval EFI_DEVICE_ERROR The device reported an error while performing the read.\r
	318	@retval EFI_NO_MEDIA There is no media in the device.\r
	319	@retval EFI_MEDIA_CHANGED The MediaId does not matched the current device.\r
	320	@retval EFI_BAD_BUFFER_SIZE The Buffer was not a multiple of the block size of the device.\r
0a6f4824	321	@retval EFI_INVALID_PARAMETER The read request contains LBAs that are not valid,\r
bcecde14	322	or the buffer is not on proper alignment.\r
	323	\r
	324	**/\r
	325	EFI_STATUS\r
	326	EFIAPI\r
	327	BiosReadLegacyDrive (\r
	328	IN EFI_BLOCK_IO_PROTOCOL *This,\r
	329	IN UINT32 MediaId,\r
	330	IN EFI_LBA Lba,\r
	331	IN UINTN BufferSize,\r
	332	OUT VOID *Buffer\r
	333	);\r
	334	\r
	335	/**\r
	336	Write BufferSize bytes from Lba into Buffer.\r
	337	\r
	338	@param This Indicates a pointer to the calling context.\r
	339	@param MediaId The media ID that the write request is for.\r
	340	@param Lba The starting logical block address to be written. The caller is\r
	341	responsible for writing to only legitimate locations.\r
	342	@param BufferSize Size of Buffer, must be a multiple of device block size.\r
	343	@param Buffer A pointer to the source buffer for the data.\r
	344	\r
	345	@retval EFI_SUCCESS The data was written correctly to the device.\r
	346	@retval EFI_WRITE_PROTECTED The device can not be written to.\r
	347	@retval EFI_DEVICE_ERROR The device reported an error while performing the write.\r
	348	@retval EFI_NO_MEDIA There is no media in the device.\r
	349	@retval EFI_MEDIA_CHNAGED The MediaId does not matched the current device.\r
	350	@retval EFI_BAD_BUFFER_SIZE The Buffer was not a multiple of the block size of the device.\r
0a6f4824	351	@retval EFI_INVALID_PARAMETER The write request contains LBAs that are not valid,\r
bcecde14	352	or the buffer is not on proper alignment.\r
	353	\r
	354	**/\r
	355	EFI_STATUS\r
	356	EFIAPI\r
	357	BiosWriteLegacyDrive (\r
	358	IN EFI_BLOCK_IO_PROTOCOL *This,\r
	359	IN UINT32 MediaId,\r
	360	IN EFI_LBA Lba,\r
	361	IN UINTN BufferSize,\r
	362	OUT VOID *Buffer\r
	363	);\r
	364	\r
	365	/**\r
	366	Gets parameters of block I/O device.\r
	367	\r
	368	@param BiosBlockIoDev Instance of block I/O device.\r
	369	@param Drive Legacy drive.\r
	370	\r
	371	@return Result of device parameter retrieval.\r
0a6f4824	372	\r
bcecde14	373	**/\r
	374	UINTN\r
	375	Int13GetDeviceParameters (\r
	376	IN BIOS_BLOCK_IO_DEV *BiosBlockIoDev,\r
	377	IN BIOS_LEGACY_DRIVE *Drive\r
	378	);\r
	379	\r
	380	/**\r
	381	Extension of INT13 call.\r
	382	\r
	383	@param BiosBlockIoDev Instance of block I/O device.\r
	384	@param Drive Legacy drive.\r
	385	\r
	386	@return Result of this extension.\r
0a6f4824	387	\r
bcecde14	388	**/\r
	389	UINTN\r
	390	Int13Extensions (\r
	391	IN BIOS_BLOCK_IO_DEV *BiosBlockIoDev,\r
	392	IN BIOS_LEGACY_DRIVE *Drive\r
	393	);\r
	394	\r
	395	/**\r
	396	Gets parameters of legacy drive.\r
	397	\r
	398	@param BiosBlockIoDev Instance of block I/O device.\r
	399	@param Drive Legacy drive.\r
	400	\r
	401	@return Result of drive parameter retrieval.\r
0a6f4824	402	\r
bcecde14	403	**/\r
	404	UINTN\r
	405	GetDriveParameters (\r
	406	IN BIOS_BLOCK_IO_DEV *BiosBlockIoDev,\r
	407	IN BIOS_LEGACY_DRIVE *Drive\r
	408	);\r
	409	\r
	410	/**\r
	411	Build device path for device.\r
	412	\r
	413	@param BaseDevicePath Base device path.\r
	414	@param Drive Legacy drive.\r
	415	@param DevicePath Device path for output.\r
	416	\r
	417	**/\r
	418	VOID\r
	419	SetBiosInitBlockIoDevicePath (\r
	420	IN EFI_DEVICE_PATH_PROTOCOL *BaseDevicePath,\r
	421	IN BIOS_LEGACY_DRIVE *Drive,\r
	422	OUT EFI_DEVICE_PATH_PROTOCOL **DevicePath\r
	423	);\r
	424	\r
	425	#endif\r