MmControl.h File Reference

Data Structures
struct	_EFI_PEI_MM_CONTROL_PPI

Macros
#define	EFI_PEI_MM_CONTROL_PPI_GUID   { 0x61c68702, 0x4d7e, 0x4f43, 0x8d, 0xef, 0xa7, 0x43, 0x5, 0xce, 0x74, 0xc5 }

Typedefs
typedef struct _EFI_PEI_MM_CONTROL_PPI	EFI_PEI_MM_CONTROL_PPI
typedef IN EFI_PEI_MM_CONTROL_PPI *	This
typedef IN EFI_PEI_MM_CONTROL_PPI IN OUT INT8 *	ArgumentBuffer
typedef IN EFI_PEI_MM_CONTROL_PPI IN OUT INT8 IN OUT UINTN *	ArgumentBufferSize
typedef IN EFI_PEI_MM_CONTROL_PPI IN OUT INT8 IN OUT UINTN IN BOOLEAN	Periodic
typedef IN EFI_PEI_MM_CONTROL_PPI IN OUT INT8 IN OUT UINTN IN BOOLEAN IN UINTN	ActivationInterval

Functions
typedef	EFI_STATUS (EFIAPI *EFI_PEI_MM_ACTIVATE)(IN EFI_PEI_SERVICES **PeiServices

Variables
EFI_GUID	gEfiPeiMmControlPpiGuid

Detailed Description

EFI MM Control PPI definition.

This PPI is used initiate synchronous MMI activations. This PPI could be published by a processor driver to abstract the MMI IPI or a driver which abstracts the ASIC that is supporting the APM port. Because of the possibility of performing MMI IPI transactions, the ability to generate this event from a platform chipset agent is an optional capability for both IA-32 and x64-based systems.

Copyright (c) 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent

Revision Reference:

This PPI is introduced in PI Version 1.5.

Macro Definition Documentation

#define EFI_PEI_MM_CONTROL_PPI_GUID   { 0x61c68702, 0x4d7e, 0x4f43, 0x8d, 0xef, 0xa7, 0x43, 0x5, 0xce, 0x74, 0xc5 }

Typedef Documentation

typedef IN EFI_PEI_MM_CONTROL_PPI IN OUT INT8 IN OUT UINTN IN BOOLEAN IN UINTN ActivationInterval

typedef IN EFI_PEI_MM_CONTROL_PPI IN OUT INT8* ArgumentBuffer

typedef IN EFI_PEI_MM_CONTROL_PPI IN OUT INT8 IN OUT UINTN* ArgumentBufferSize

typedef struct _EFI_PEI_MM_CONTROL_PPI EFI_PEI_MM_CONTROL_PPI

typedef IN EFI_PEI_MM_CONTROL_PPI IN BOOLEAN Periodic

typedef IN EFI_PEI_MP_SERVICES_PPI * This

Function Documentation

typedef EFI_STATUS

(

EFIAPI *

EFI_PEI_MM_DEACTIVATE

)

Invokes PPI activation from the PI PEI environment.

Parameters

PeiServices	An indirect pointer to the PEI Services Table published by the PEI Foundation.
This	The PEI_MM_CONTROL_PPI instance.
ArgumentBuffer	The value passed to the MMI handler. This value corresponds to the SwMmiInputValue in the RegisterContext parameter for the Register() function in the EFI_MM_SW_DISPATCH_PROTOCOL and in the Context parameter in the call to the DispatchFunction
ArgumentBufferSize	The size of the data passed in ArgumentBuffer or NULL if ArgumentBuffer is NULL.
Periodic	An optional mechanism to periodically repeat activation.
ActivationInterval	An optional parameter to repeat at this period one time or, if the Periodic Boolean is set, periodically.

Return values

EFI_SUCCESS	The MMI has been engendered.
EFI_DEVICE_ERROR	The timing is unsupported.
EFI_INVALID_PARAMETER	The activation period is unsupported.
EFI_NOT_STARTED	The MM base service has not been initialized.

Clears any system state that was created in response to the Trigger() call.

Parameters

PeiServices	General purpose services available to every PEIM.
This	The PEI_MM_CONTROL_PPI instance.
Periodic	Optional parameter to repeat at this period one time or, if the Periodic Boolean is set, periodically.

Return values

EFI_SUCCESS	The MMI has been engendered.
EFI_DEVICE_ERROR	The source could not be cleared.
EFI_INVALID_PARAMETER	The service did not support the Periodic input argument.

Variable Documentation

EFI_GUID gEfiPeiMmControlPpiGuid