/** @file
|
PCH SMM IO Trap Control Protocol
|
|
Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
|
SPDX-License-Identifier: BSD-2-Clause-Patent
|
**/
|
#ifndef _PCH_SMM_IO_TRAP_CONTROL_H_
|
#define _PCH_SMM_IO_TRAP_CONTROL_H_
|
|
|
//
|
// Extern the GUID for protocol users.
|
//
|
extern EFI_GUID gPchSmmIoTrapControlGuid;
|
|
//
|
// Forward reference for ANSI C compatibility
|
//
|
typedef struct _PCH_SMM_IO_TRAP_CONTROL_PROTOCOL PCH_SMM_IO_TRAP_CONTROL_PROTOCOL;
|
|
//
|
// Related Definitions
|
//
|
|
//
|
// Member functions
|
//
|
|
/**
|
The Prototype of Pause and Resume IoTrap callback function.
|
|
@param[in] This Pointer to the PCH_SMM_IO_TRAP_CONTROL_PROTOCOL instance.
|
@param[in] DispatchHandle Handle of the child service to change state.
|
|
@retval EFI_SUCCESS This operation is complete.
|
@retval EFI_INVALID_PARAMETER The DispatchHandle is invalid.
|
@retval EFI_ACCESS_DENIED The SMI status is alrady PAUSED/RESUMED.
|
**/
|
typedef
|
EFI_STATUS
|
(EFIAPI *PCH_SMM_IO_TRAP_CONTROL_FUNCTION) (
|
IN PCH_SMM_IO_TRAP_CONTROL_PROTOCOL * This,
|
IN EFI_HANDLE DispatchHandle
|
);
|
|
/**
|
Interface structure for the SMM IO trap pause and resume protocol
|
This protocol provides the functions to runtime control the IoTrap SMI enabled/disable.
|
This applys the capability to the DispatchHandle which returned by IoTrap callback
|
registration, and the DispatchHandle which must be MergeDisable = TRUE and Address != 0.
|
Besides, when S3 resuem, it only restores the state of IoTrap callback registration.
|
The Paused/Resume state won't be restored after S3 resume.
|
**/
|
struct _PCH_SMM_IO_TRAP_CONTROL_PROTOCOL {
|
/**
|
This runtime pauses a registered IoTrap handler.
|
**/
|
PCH_SMM_IO_TRAP_CONTROL_FUNCTION Pause;
|
/**
|
This runtime resumes a registered IoTrap handler.
|
**/
|
PCH_SMM_IO_TRAP_CONTROL_FUNCTION Resume;
|
};
|
|
#endif
|
