4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Functions to deal with Disk buffer.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Copyright (c) 2005 - 2011, Intel Corporation. All rights reserved. <BR>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync This program and the accompanying materials
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync are licensed and made available under the terms and conditions of the BSD License
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync which accompanies this distribution. The full text of the license may be found at
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync// for basic initialization of HDiskImage
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Initialization function for HDiskImage.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_SUCCESS The operation was successful.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_LOAD_ERROR A load error occured.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // basically initialize the HDiskImage
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync CopyMem (&HDiskImage, &HDiskImageConst, sizeof (HDiskImage));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync CopyMem (&HDiskImageBackupVar, &HDiskImageConst, sizeof (HDiskImageBackupVar));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Backup function for HDiskImage. Only a few fields need to be backup.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync This is for making the Disk buffer refresh as few as possible.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_SUCCESS The operation was successful.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_OUT_OF_RESOURCES gST->ConOut of resources.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // backup the disk name, offset and size
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync HDiskImageBackupVar.Name = CatSPrint(NULL, L"%s", HDiskImage.Name);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Cleanup function for HDiskImage.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_SUCCESS The operation was successful.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Set FileName field in HFileImage.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param[in] Str File name to set.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param[in] Offset The offset.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param[in] Size The size.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_SUCCESS The operation was successful.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_OUT_OF_RESOURCES A memory allocation failed.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // free the old file name
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync HDiskImage.Name = AllocateZeroPool (2 * (Len + 1));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Read a disk from disk into HBufferImage.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param[in] DeviceName filename to read.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param[in] Offset The offset.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param[in] Size The size.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param[in] Recover if is for recover, no information print.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_SUCCESS The operation was successful.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_OUT_OF_RESOURCES A memory allocation failed.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_LOAD_ERROR A load error occured.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_INVALID_PARAMETER A parameter was invalid.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DevicePath = gEfiShellProtocol->GetDevicePathFromMap(DeviceName);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // get blkio interface
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = gBS->LocateDevicePath(&gEfiBlockIoProtocolGuid,&DupDevicePath,&Handle);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = gBS->OpenProtocol(Handle, &gEfiBlockIoProtocolGuid, (VOID**)&BlkIo, gImageHandle, NULL, EFI_OPEN_PROTOCOL_GET_PROTOCOL);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // if Offset exceeds LastBlock,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // return error
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (Offset > BlkIo->Media->LastBlock || Offset + Size > BlkIo->Media->LastBlock) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync StatusBarSetStatusString (L"Invalid Offset + Size");
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ByteOffset = MultU64x32 (Offset, BlkIo->Media->BlockSize);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // read from disk
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // convert buffer to line list
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = HDiskImageSetDiskNameOffsetSize (DeviceName, Offset, Size);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // initialize some variables
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Str = CatSPrint(NULL, L"%d Lines Read", HBufferImage.NumLines);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // has line
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // create a dummy line
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Save lines in HBufferImage to disk.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync NOT ALLOW TO WRITE TO ANOTHER DISK!!!!!!!!!
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param[in] DeviceName The device name.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param[in] Offset The offset.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param[in] Size The size.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_SUCCESS The operation was successful.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_OUT_OF_RESOURCES A memory allocation failed.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_LOAD_ERROR A load error occured.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_INVALID_PARAMETER A parameter was invalid.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // if not modified, directly return
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DevicePath = gEfiShellProtocol->GetDevicePathFromMap(DeviceName);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync// StatusBarSetStatusString (L"Cannot Find Device");
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // get blkio interface
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = gBS->LocateDevicePath(&gEfiBlockIoProtocolGuid,&DupDevicePath,&Handle);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync// StatusBarSetStatusString (L"Read Disk Failed");
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = gBS->OpenProtocol(Handle, &gEfiBlockIoProtocolGuid, (VOID**)&BlkIo, gImageHandle, NULL, EFI_OPEN_PROTOCOL_GET_PROTOCOL);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync// StatusBarSetStatusString (L"Read Disk Failed");
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // concatenate the line list to a buffer
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ByteOffset = MultU64x32 (Offset, BlkIo->Media->BlockSize);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // write the buffer to disk
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // now not modified