sravan/system76-edk2
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Minor adjustments.

Browse Source 
git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@1480 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
qhuang8 2006-09-06 07:38:37 +00:00
parent 738338d83e
commit b30d28b3d4
1 changed files with 46 additions and 67 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

113
Tools/Conf/Migration/R8Lib.c
View File

@ -1,5 +1,8 @@
/** @file /** @file
Obsolete library. Obsolete library interfaces.
This file contains part of obsolete library interfaces in EDK.
User is recommended to follow the porting Guide in R8Lib.c to elimante them.
Copyright (c) 2006, Intel Corporation Copyright (c) 2006, Intel Corporation
All rights reserved. This program and the accompanying materials All rights reserved. This program and the accompanying materials
@ -12,7 +15,7 @@
**/ **/
//// ////#UefiBootServicesTableLib
EFI_STATUS EFI_STATUS
R8_EfiLibInstallDriverBinding ( R8_EfiLibInstallDriverBinding (
IN EFI_HANDLE ImageHandle, IN EFI_HANDLE ImageHandle,
@ -32,27 +35,23 @@ Routine Description:
Arguments: Arguments:
ImageHandle - The image handle of the driver ImageHandle - The image handle of the driver.
SystemTable - The EFI System Table that was passed to the driver's entry point SystemTable - The EFI System Table that was passed to the driver's entry point
DriverBinding - A Driver Binding Protocol instance that this driver is producing DriverBinding - A Driver Binding Protocol instance that this driver is producing
DriverBindingHandle - The handle that DriverBinding is to be installe onto. If this DriverBindingHandle - The handle that DriverBinding is to be installe onto. If this
parameter is NULL, then a new handle is created. parameter is NULL, then a new handle is created.
Returns: Returns:
EFI_SUCCESS is DriverBinding is installed onto DriverBindingHandle EFI_SUCCESS - DriverBinding is installed onto DriverBindingHandle
Others - Some error occurs when executing gBS->InstallProtocolInterface()
Otherwise, then return status from gBS->InstallProtocolInterface()
--*/ --*/
{ {
// //
// Porting Guide: // Porting Guide:
// This obsolete Edk library interface installs driver binding protocol. // This obsolete Edk library interface installs driver binding protocol.
// If the entry point of that module only invoke this function, it can // If the entry point of that module ONLY invokes this function, it can
// use UefiDriverModuleLib in MdePkg and expose "DriverBinding" protocol interface // use UefiDriverModuleLib in MdePkg and expose "DriverBinding" protocol interface
// at the <Externs> tag, build tool will auto generate code to handle it. // at the <Externs> tag, build tool will auto generate code to handle it.
// For example: // For example:
@ -63,7 +62,6 @@ Returns:
// </Externs> // </Externs>
// //
DriverBinding->ImageHandle = ImageHandle; DriverBinding->ImageHandle = ImageHandle;
DriverBinding->DriverBindingHandle = DriverBindingHandle; DriverBinding->DriverBindingHandle = DriverBindingHandle;
return gBS->InstallProtocolInterface ( return gBS->InstallProtocolInterface (
@ -75,16 +73,16 @@ Returns:
} }
////~ ////~
//// ////#UefiBootServicesTableLib
EFI_STATUS EFI_STATUS
R8_EfiLibInstallAllDriverProtocols ( R8_EfiLibInstallAllDriverProtocols (
IN EFI_HANDLE ImageHandle, IN EFI_HANDLE ImageHandle,
IN EFI_SYSTEM_TABLE * SystemTable, IN EFI_SYSTEM_TABLE *SystemTable,
IN EFI_DRIVER_BINDING_PROTOCOL * DriverBinding, IN EFI_DRIVER_BINDING_PROTOCOL *DriverBinding,
IN EFI_HANDLE DriverBindingHandle, IN EFI_HANDLE DriverBindingHandle,
IN EFI_COMPONENT_NAME_PROTOCOL * ComponentName, OPTIONAL IN EFI_COMPONENT_NAME_PROTOCOL *ComponentName, OPTIONAL
IN EFI_DRIVER_CONFIGURATION_PROTOCOL * DriverConfiguration, OPTIONAL IN EFI_DRIVER_CONFIGURATION_PROTOCOL *DriverConfiguration, OPTIONAL
IN EFI_DRIVER_DIAGNOSTICS_PROTOCOL * DriverDiagnostics OPTIONAL IN EFI_DRIVER_DIAGNOSTICS_PROTOCOL *DriverDiagnostics OPTIONAL
) )
/*++ /*++
@ -99,25 +97,18 @@ Routine Description:
Arguments: Arguments:
ImageHandle - The image handle of the driver ImageHandle - The image handle of the driver
SystemTable - The EFI System Table that was passed to the driver's entry point SystemTable - The EFI System Table that was passed to the driver's entry point
DriverBinding - A Driver Binding Protocol instance that this driver is producing DriverBinding - A Driver Binding Protocol instance that this driver is producing
DriverBindingHandle - The handle that DriverBinding is to be installe onto. If this DriverBindingHandle - The handle that DriverBinding is to be installe onto. If this
parameter is NULL, then a new handle is created. parameter is NULL, then a new handle is created.
ComponentName - A Component Name Protocol instance that this driver is producing ComponentName - A Component Name Protocol instance that this driver is producing
DriverConfiguration - A Driver Configuration Protocol instance that this driver is producing DriverConfiguration - A Driver Configuration Protocol instance that this driver is producing
DriverDiagnostics - A Driver Diagnostics Protocol instance that this driver is producing DriverDiagnostics - A Driver Diagnostics Protocol instance that this driver is producing
Returns: Returns:
EFI_SUCCESS if all the protocols were installed onto DriverBindingHandle EFI_SUCCESS - DriverBinding is installed onto DriverBindingHandle
Others - Some error occurs when executing gBS->InstallProtocolInterface()
Otherwise, then return status from gBS->InstallProtocolInterface()
--*/ --*/
{ {
@ -125,7 +116,7 @@ Returns:
// Porting Guide: // Porting Guide:
// This obsolete Edk library interface installs driver binding protocol // This obsolete Edk library interface installs driver binding protocol
// with optional component name, driver configuration & driver diagnotics protocols. // with optional component name, driver configuration & driver diagnotics protocols.
// If the entry point of that module only invoke this function, it can // If the entry point of that module ONLY invokes this function, it can
// use UefiDriverModuleLib in MdePkg and expose "DriverBinding", "ComponentName", // use UefiDriverModuleLib in MdePkg and expose "DriverBinding", "ComponentName",
// "DriverConfiguration" and "DriverDiagnostics" protocol interfaces. // "DriverConfiguration" and "DriverDiagnostics" protocol interfaces.
// at the <Externs> tag, build tool will auto generate code to handle it. // at the <Externs> tag, build tool will auto generate code to handle it.
@ -141,7 +132,15 @@ Returns:
// //
EFI_STATUS Status; EFI_STATUS Status;
Status = R8_EfiLibInstallDriverBinding (ImageHandle, SystemTable, DriverBinding, DriverBindingHandle); DriverBinding->ImageHandle = ImageHandle;
DriverBinding->DriverBindingHandle = DriverBindingHandle;
Status = gBS->InstallProtocolInterface (
&DriverBinding->DriverBindingHandle,
&gEfiDriverBindingProtocolGuid,
EFI_NATIVE_INTERFACE,
DriverBinding
);
if (EFI_ERROR (Status)) { if (EFI_ERROR (Status)) {
return Status; return Status;
} }
@ -242,16 +241,16 @@ R8_BufToHexString (
At a minimum, any blob of data could be represented as a hex string. At a minimum, any blob of data could be represented as a hex string.
Arguments: Arguments:
Str - Pointer to the string. Str - Pointer to the string.
HexStringBufferLength - Length in bytes of buffer to hold the hex string. Includes tailing '\0' character. HexStringBufferLength - Length in bytes of buffer to hold the hex string. Includes tailing '\0' character.
If routine return with EFI_SUCCESS, containing length of hex string buffer. If routine return with EFI_SUCCESS, containing length of hex string buffer.
If routine return with EFI_BUFFER_TOO_SMALL, containg length of hex string buffer desired. If routine return with EFI_BUFFER_TOO_SMALL, containg length of hex string buffer desired.
Buf - Buffer to be converted from. Buf - Buffer to be converted from.
Len - Length in bytes of the buffer to be converted. Len - Length in bytes of the buffer to be converted.
Returns: Returns:
EFI_SUCCESS: Routine success. EFI_SUCCESS - Routine success.
EFI_BUFFER_TOO_SMALL: The hex string buffer is too small. EFI_BUFFER_TOO_SMALL - The hex string buffer is too small.
--*/ --*/
{ {
@ -308,9 +307,7 @@ Arguments:
str - Pointer to the null-terminated string to be trimmed. On return, str - Pointer to the null-terminated string to be trimmed. On return,
str will hold the trimmed string. str will hold the trimmed string.
CharC - Character will be trimmed from str. CharC - Character will be trimmed from str.
Returns:
--*/ --*/
{ {
@ -375,11 +372,8 @@ Routine Description:
Arguments: Arguments:
Buffer - Location to place ascii hex string of Value. Buffer - Location to place ascii hex string of Value.
Value - Hex value to convert to a string in Buffer. Value - Hex value to convert to a string in Buffer.
Flags - Flags to use in printing Hex string, see file header for details. Flags - Flags to use in printing Hex string, see file header for details.
Width - Width of hex value. Width - Width of hex value.
Returns: Returns:
@ -482,9 +476,8 @@ R8_HexStringToBuf (
ConvertedStrLen - Length of the Hex String consumed. ConvertedStrLen - Length of the Hex String consumed.
Returns: Returns:
EFI_SUCCESS: Routine Success. EFI_SUCCESS - Routine Success.
EFI_BUFFER_TOO_SMALL: The buffer is too small to hold converted data. EFI_BUFFER_TOO_SMALL - The buffer is too small to hold converted data.
EFI_
--*/ --*/
{ {
@ -645,13 +638,13 @@ Routine Description:
Arguments: Arguments:
Type The HOB type to return. Type - The HOB type to return.
HobStart The first HOB in the HOB list. HobStart - The first HOB in the HOB list.
Returns: Returns:
HobStart There were no HOBs found with the requested type. HobStart - There were no HOBs found with the requested type.
else Returns the first HOB with the matching type. Other - The first HOB with the matching type.
--*/ --*/
{ {
@ -771,13 +764,11 @@ Routine Description:
Arguments: Arguments:
HobStart - Start pointer of hob list HobStart - Start pointer of hob list
BootMode - Current boot mode recorded in PHIT hob BootMode - Current boot mode recorded in PHIT hob
Returns: Returns:
EFI_NOT_FOUND - Invalid hob header EFI_NOT_FOUND - Invalid hob header
EFI_SUCCESS - Boot mode found EFI_SUCCESS - Boot mode found
--*/ --*/
@ -792,7 +783,7 @@ Returns:
// EFI_HOB_HANDOFF_INFO_TABLE *HandOffHob; // EFI_HOB_HANDOFF_INFO_TABLE *HandOffHob;
// //
// HandOffHob = GetHobList (); // HandOffHob = GetHobList ();
// ASSERT (HandOffHob->Header.HobType = EFI_HOB_TYPE_HANDOFF); // ASSERT (HandOffHob->Header.HobType == EFI_HOB_TYPE_HANDOFF);
// //
// BootMode = HandOffHob->BootMode; // BootMode = HandOffHob->BootMode;
// //
@ -825,15 +816,12 @@ Routine Description:
Arguments: Arguments:
HobStart - Start pointer of hob list HobStart - Start pointer of hob list
SizeOfMemorySpace - Size of memory size SizeOfMemorySpace - Size of memory size
SizeOfIoSpace - Size of IO size SizeOfIoSpace - Size of IO size
Returns: Returns:
EFI_NOT_FOUND - CPU hob not found EFI_NOT_FOUND - CPU hob not found
EFI_SUCCESS - CPU hob found and information got. EFI_SUCCESS - CPU hob found and information got.
--*/ --*/
@ -936,15 +924,12 @@ Routine Description:
Arguments: Arguments:
HobStart - Start pointer of hob list HobStart - Start pointer of hob list
BaseAddress - Start address of next firmware volume BaseAddress - Start address of next firmware volume
Length - Length of next firmware volume Length - Length of next firmware volume
Returns: Returns:
EFI_NOT_FOUND - Next firmware volume not found EFI_NOT_FOUND - Next firmware volume not found
EFI_SUCCESS - Next firmware volume found with address information EFI_SUCCESS - Next firmware volume found with address information
--*/ --*/
@ -998,18 +983,14 @@ Routine Description:
Get the next guid hob. Get the next guid hob.
Arguments: Arguments:
HobStart A pointer to the start hob. HobStart - A pointer to the start hob.
Guid A pointer to a guid. Guid - A pointer to a guid.
Buffer A pointer to the buffer. Buffer - A pointer to the buffer.
BufferSize Buffer size. BufferSize - Buffer size.
Returns: Returns:
Status code.
EFI_NOT_FOUND - Next Guid hob not found EFI_NOT_FOUND - Next Guid hob not found
EFI_SUCCESS - Next Guid hob found and data for this Guid got EFI_SUCCESS - Next Guid hob found and data for this Guid got
EFI_INVALID_PARAMETER - invalid parameter EFI_INVALID_PARAMETER - invalid parameter
--*/ --*/
@ -1062,7 +1043,6 @@ Routine Description:
Arguments: Arguments:
HobStart - Start pointer of hob list HobStart - Start pointer of hob list
PalEntry - Pointer to PAL entry PalEntry - Pointer to PAL entry
Returns: Returns:
@ -1099,7 +1079,6 @@ Routine Description:
Arguments: Arguments:
HobStart - Start pointer of hob list HobStart - Start pointer of hob list
IoPortSpaceAddress - IO port space address IoPortSpaceAddress - IO port space address
Returns: Returns: