https://bugzilla.tianocore.org/show_bug.cgi?id=1373 Replace BSD 2-Clause License with BSD+Patent License. This change is based on the following emails: https://lists.01.org/pipermail/edk2-devel/2019-February/036260.html https://lists.01.org/pipermail/edk2-devel/2018-October/030385.html RFCs with detailed process for the license change: V3: https://lists.01.org/pipermail/edk2-devel/2019-March/038116.html V2: https://lists.01.org/pipermail/edk2-devel/2019-March/037669.html V1: https://lists.01.org/pipermail/edk2-devel/2019-March/037500.html Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com> Reviewed-by: Hao Wu <hao.a.wu@intel.com> Reviewed-by: Jian J Wang <jian.j.wang@intel.com>
		
			
				
	
	
		
			107 lines
		
	
	
		
			3.9 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			107 lines
		
	
	
		
			3.9 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/** @file
 | 
						|
  SMM driver instance of SmiHandlerProfile Library.
 | 
						|
 | 
						|
  Copyright (c) 2017, Intel Corporation. All rights reserved.<BR>
 | 
						|
  SPDX-License-Identifier: BSD-2-Clause-Patent
 | 
						|
 | 
						|
**/
 | 
						|
 | 
						|
#include <PiSmm.h>
 | 
						|
#include <Library/SmiHandlerProfileLib.h>
 | 
						|
#include <Library/SmmServicesTableLib.h>
 | 
						|
#include <Guid/SmiHandlerProfile.h>
 | 
						|
 | 
						|
SMI_HANDLER_PROFILE_PROTOCOL  *mSmiHandlerProfile;
 | 
						|
 | 
						|
/**
 | 
						|
  This function is called by SmmChildDispatcher module to report
 | 
						|
  a new SMI handler is registered, to SmmCore.
 | 
						|
 | 
						|
  @param HandlerGuid     The GUID to identify the type of the handler.
 | 
						|
                         For the SmmChildDispatch protocol, the HandlerGuid
 | 
						|
                         must be the GUID of SmmChildDispatch protocol.
 | 
						|
  @param Handler         The SMI handler.
 | 
						|
  @param CallerAddress   The address of the module who registers the SMI handler.
 | 
						|
  @param Context         The context of the SMI handler.
 | 
						|
                         For the SmmChildDispatch protocol, the Context
 | 
						|
                         must match the one defined for SmmChildDispatch protocol.
 | 
						|
  @param ContextSize     The size of the context in bytes.
 | 
						|
                         For the SmmChildDispatch protocol, the Context
 | 
						|
                         must match the one defined for SmmChildDispatch protocol.
 | 
						|
 | 
						|
  @retval EFI_SUCCESS           The information is recorded.
 | 
						|
  @retval EFI_UNSUPPORTED       The feature is unsupported.
 | 
						|
  @retval EFI_OUT_OF_RESOURCES  There is no enough resource to record the information.
 | 
						|
**/
 | 
						|
EFI_STATUS
 | 
						|
EFIAPI
 | 
						|
SmiHandlerProfileRegisterHandler (
 | 
						|
  IN EFI_GUID                       *HandlerGuid,
 | 
						|
  IN EFI_SMM_HANDLER_ENTRY_POINT2   Handler,
 | 
						|
  IN PHYSICAL_ADDRESS               CallerAddress,
 | 
						|
  IN VOID                           *Context, OPTIONAL
 | 
						|
  IN UINTN                          ContextSize OPTIONAL
 | 
						|
  )
 | 
						|
{
 | 
						|
  if (mSmiHandlerProfile != NULL) {
 | 
						|
    return mSmiHandlerProfile->RegisterHandler (mSmiHandlerProfile, HandlerGuid, Handler, CallerAddress, Context, ContextSize);
 | 
						|
  }
 | 
						|
  return EFI_UNSUPPORTED;
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
  This function is called by SmmChildDispatcher module to report
 | 
						|
  an existing SMI handler is unregistered, to SmmCore.
 | 
						|
 | 
						|
  @param HandlerGuid     The GUID to identify the type of the handler.
 | 
						|
                         For the SmmChildDispatch protocol, the HandlerGuid
 | 
						|
                         must be the GUID of SmmChildDispatch protocol.
 | 
						|
  @param Handler         The SMI handler.
 | 
						|
  @param Context         The context of the SMI handler.
 | 
						|
                         If it is NOT NULL, it will be used to check what is registered.
 | 
						|
  @param ContextSize     The size of the context in bytes.
 | 
						|
                         If Context is NOT NULL, it will be used to check what is registered.
 | 
						|
 | 
						|
  @retval EFI_SUCCESS           The original record is removed.
 | 
						|
  @retval EFI_UNSUPPORTED       The feature is unsupported.
 | 
						|
  @retval EFI_NOT_FOUND         There is no record for the HandlerGuid and handler.
 | 
						|
**/
 | 
						|
EFI_STATUS
 | 
						|
EFIAPI
 | 
						|
SmiHandlerProfileUnregisterHandler (
 | 
						|
  IN EFI_GUID                       *HandlerGuid,
 | 
						|
  IN EFI_SMM_HANDLER_ENTRY_POINT2   Handler,
 | 
						|
  IN VOID                           *Context, OPTIONAL
 | 
						|
  IN UINTN                          ContextSize OPTIONAL
 | 
						|
  )
 | 
						|
{
 | 
						|
  if (mSmiHandlerProfile != NULL) {
 | 
						|
    return mSmiHandlerProfile->UnregisterHandler (mSmiHandlerProfile, HandlerGuid, Handler, Context, ContextSize);
 | 
						|
  }
 | 
						|
  return EFI_UNSUPPORTED;
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
  The constructor function for SMI handler profile.
 | 
						|
 | 
						|
  @param  ImageHandle   The firmware allocated handle for the EFI image.
 | 
						|
  @param  SystemTable   A pointer to the EFI System Table.
 | 
						|
 | 
						|
  @retval EFI_SUCCESS   The constructor always returns EFI_SUCCESS.
 | 
						|
**/
 | 
						|
EFI_STATUS
 | 
						|
EFIAPI
 | 
						|
SmmSmiHandlerProfileLibConstructor (
 | 
						|
  IN EFI_HANDLE        ImageHandle,
 | 
						|
  IN EFI_SYSTEM_TABLE  *SystemTable
 | 
						|
  )
 | 
						|
{
 | 
						|
  gSmst->SmmLocateProtocol (
 | 
						|
           &gSmiHandlerProfileGuid,
 | 
						|
           NULL,
 | 
						|
           (VOID **) &mSmiHandlerProfile
 | 
						|
           );
 | 
						|
  return EFI_SUCCESS;
 | 
						|
}
 | 
						|
 |