blob: 5d0a4d34cff60aff04c4a3a5c67544ecf52f9b07 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
|
/** @file
PCH SMM IO Trap Control Protocol
Copyright (c) 2017, Intel Corporation. All rights reserved.<BR>
This program and the accompanying materials are licensed and made available under
the terms and conditions of the BSD License that 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.
**/
#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
|