#include <PiSmm.h>

Include dependency graph for SmiHandlerProfileLib.h:

Functions
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)

EFI_STATUS EFIAPI	SmiHandlerProfileUnregisterHandler (IN EFI_GUID HandlerGuid, IN EFI_SMM_HANDLER_ENTRY_POINT2 Handler, IN VOID Context, OPTIONAL IN UINTN ContextSize OPTIONAL)

Detailed Description

Provides services to log the SMI handler registration.

This API provides services for the SMM Child Dispatch Protocols provider, to register SMI handler information to SmmCore.

NOTE: There is no need to update the consumers of SMST->SmiHandlerRegister() or the consumers of SMM Child Dispatch Protocols. The SmmCore (who produces SMST) should have ability to register such information directly. The SmmChildDispatcher (who produces SMM Child Dispatch Protocols) should be responsible to call the services to register information to SMM Core.

Copyright (c) 2017, Intel Corporation. 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.

Function Documentation

◆ SmiHandlerProfileRegisterHandler()

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
	)

This function is called by SmmChildDispatcher module to report a new SMI handler is registered, to SmmCore.

Parameters

HandlerGuid	The GUID to identify the type of the handler. For the SmmChildDispatch protocol, the HandlerGuid must be the GUID of SmmChildDispatch protocol.
Handler	The SMI handler.
CallerAddress	The address of the module who registers the SMI handler.
Context	The context of the SMI handler. For the SmmChildDispatch protocol, the Context must match the one defined for SmmChildDispatch protocol.
ContextSize	The size of the context in bytes. For the SmmChildDispatch protocol, the Context must match the one defined for SmmChildDispatch protocol.

Return values

EFI_SUCCESS	The information is recorded.
EFI_UNSUPPORTED	The feature is unsupported.
EFI_OUT_OF_RESOURCES	There is no enough resource to record the information.

◆ SmiHandlerProfileUnregisterHandler()

EFI_STATUS EFIAPI SmiHandlerProfileUnregisterHandler	(	IN EFI_GUID *	HandlerGuid,
		IN EFI_SMM_HANDLER_ENTRY_POINT2	Handler,
		IN VOID *	Context,
		OPTIONAL IN UINTN ContextSize	OPTIONAL
	)

This function is called by SmmChildDispatcher module to report an existing SMI handler is unregistered, to SmmCore.