2281e7a9c3
git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@6967 6f19259b-4bc3-4df7-8a09-765794883524
120 lines
3.5 KiB
C
120 lines
3.5 KiB
C
/** @file
|
|
Entry point library instance to a UEFI application.
|
|
|
|
Copyright (c) 2007, Intel Corporation<BR>
|
|
All rights reserved. This program and the accompanying materials
|
|
are licensed and made available under the terms and conditions of the BSD License
|
|
which accompanies this distribution. The full text of the license may be found at
|
|
http://opensource.org/licenses/bsd-license.php
|
|
|
|
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
|
|
|
**/
|
|
|
|
#include <Uefi.h>
|
|
#include <Library/UefiApplicationEntryPoint.h>
|
|
#include <Library/UefiBootServicesTableLib.h>
|
|
|
|
|
|
/**
|
|
Enrty point to UEFI Application.
|
|
|
|
This function is the entry point for a UEFI Application. This function must call
|
|
ProcessLibraryConstructorList(), ProcessModuleEntryPointList(), and ProcessLibraryDestructorList().
|
|
The return value from ProcessModuleEntryPointList() is returned.
|
|
If _gUefiDriverRevision is not zero and SystemTable->Hdr.Revision is less than _gUefiDriverRevison,
|
|
then return EFI_INCOMPATIBLE_VERSION.
|
|
|
|
@param ImageHandle The image handle of the UEFI Application.
|
|
@param SystemTable A pointer to the EFI System Table.
|
|
|
|
@retval EFI_SUCCESS The UEFI Application exited normally.
|
|
@retval EFI_INCOMPATIBLE_VERSION _gUefiDriverRevision is greater than SystemTable->Hdr.Revision.
|
|
@retval Other Return value from ProcessModuleEntryPointList().
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
_ModuleEntryPoint (
|
|
IN EFI_HANDLE ImageHandle,
|
|
IN EFI_SYSTEM_TABLE *SystemTable
|
|
)
|
|
{
|
|
EFI_STATUS Status;
|
|
|
|
if (_gUefiDriverRevision != 0) {
|
|
//
|
|
// Make sure that the EFI/UEFI spec revision of the platform is >= EFI/UEFI spec revision of the application.
|
|
//
|
|
if (SystemTable->Hdr.Revision < _gUefiDriverRevision) {
|
|
return EFI_INCOMPATIBLE_VERSION;
|
|
}
|
|
}
|
|
|
|
//
|
|
// Call constructor for all libraries.
|
|
//
|
|
ProcessLibraryConstructorList (ImageHandle, SystemTable);
|
|
|
|
//
|
|
// Call the module's entry point
|
|
//
|
|
Status = ProcessModuleEntryPointList (ImageHandle, SystemTable);
|
|
|
|
//
|
|
// Process destructor for all libraries.
|
|
//
|
|
ProcessLibraryDestructorList (ImageHandle, SystemTable);
|
|
|
|
//
|
|
// Return the return status code from the driver entry point
|
|
//
|
|
return Status;
|
|
}
|
|
|
|
|
|
/**
|
|
Invokes the library destructors for all dependent libraries and terminates
|
|
the UEFI Application.
|
|
|
|
This function calls ProcessLibraryDestructorList() and the EFI Boot Service Exit()
|
|
with a status specified by Status.
|
|
|
|
@param Status Status returned by the application that is exiting.
|
|
|
|
**/
|
|
VOID
|
|
EFIAPI
|
|
Exit (
|
|
IN EFI_STATUS Status
|
|
)
|
|
|
|
{
|
|
ProcessLibraryDestructorList (gImageHandle, gST);
|
|
|
|
gBS->Exit (gImageHandle, Status, 0, NULL);
|
|
}
|
|
|
|
|
|
/**
|
|
Required by the EBC compiler and identical in functionality to _ModuleEntryPoint().
|
|
|
|
@param ImageHandle The image handle of the UEFI Application.
|
|
@param SystemTable A pointer to the EFI System Table.
|
|
|
|
@retval EFI_SUCCESS The UEFI Application exited normally.
|
|
@retval EFI_INCOMPATIBLE_VERSION _gUefiDriverRevision is greater than SystemTable->Hdr.Revision.
|
|
@retval Other Return value from ProcessModuleEntryPointList().
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
EfiMain (
|
|
IN EFI_HANDLE ImageHandle,
|
|
IN EFI_SYSTEM_TABLE *SystemTable
|
|
)
|
|
{
|
|
return _ModuleEntryPoint (ImageHandle, SystemTable);
|
|
}
|