- @param[in] This The EFI_SMM_ACCESS2_PROTOCOL instance.\r
-\r
- @retval EFI_SUCCESS The operation was successful.\r
- @retval EFI_UNSUPPORTED The system does not support opening and closing of SMRAM.\r
- @retval EFI_DEVICE_ERROR SMRAM cannot be opened, perhaps because it is locked.\r
-**/\r
-typedef\r
-EFI_STATUS\r
-(EFIAPI *EFI_SMM_OPEN2)(\r
- IN EFI_SMM_ACCESS2_PROTOCOL *This\r
- );\r
-\r
-/**\r
- Inhibits access to the SMRAM.\r
-\r
- This function "closes" SMRAM so that it is not visible while outside of SMM. The function should \r
- return EFI_UNSUPPORTED if the hardware does not support hiding of SMRAM.\r
-\r
- @param[in] This The EFI_SMM_ACCESS2_PROTOCOL instance.\r
-\r
- @retval EFI_SUCCESS The operation was successful.\r
- @retval EFI_UNSUPPORTED The system does not support opening and closing of SMRAM.\r
- @retval EFI_DEVICE_ERROR SMRAM cannot be closed.\r
-**/\r
-typedef\r
-EFI_STATUS\r
-(EFIAPI *EFI_SMM_CLOSE2)(\r
- IN EFI_SMM_ACCESS2_PROTOCOL *This\r
- );\r
-\r
-/**\r
- Inhibits access to the SMRAM.\r
-\r
- This function prohibits access to the SMRAM region. This function is usually implemented such \r
- that it is a write-once operation. \r
-\r
- @param[in] This The EFI_SMM_ACCESS2_PROTOCOL instance.\r
-\r
- @retval EFI_SUCCESS The device was successfully locked.\r
- @retval EFI_UNSUPPORTED The system does not support locking of SMRAM.\r
-**/\r
-typedef\r
-EFI_STATUS\r
-(EFIAPI *EFI_SMM_LOCK2)(\r
- IN EFI_SMM_ACCESS2_PROTOCOL *This\r
- );\r
-\r
-/**\r
- Queries the memory controller for the possible regions that will support SMRAM.\r
-\r
- @param[in] This The EFI_SMM_ACCESS2_PROTOCOL instance.\r
- @param[in,out] SmramMapSize A pointer to the size, in bytes, of the SmramMemoryMap buffer.\r
- @param[in,out] SmramMap A pointer to the buffer in which firmware places the current memory map.\r
-\r
- @retval EFI_SUCCESS The chipset supported the given resource.\r
- @retval EFI_BUFFER_TOO_SMALL The SmramMap parameter was too small. The current buffer size \r
- needed to hold the memory map is returned in SmramMapSize.\r
-**/\r
-typedef\r
-EFI_STATUS\r
-(EFIAPI *EFI_SMM_CAPABILITIES2)(\r
- IN CONST EFI_SMM_ACCESS2_PROTOCOL *This,\r
- IN OUT UINTN *SmramMapSize,\r
- IN OUT EFI_SMRAM_DESCRIPTOR *SmramMap\r
- );\r
-\r
-///\r
-/// EFI SMM Access2 Protocol is used to control the visibility of the SMRAM on the platform.\r
-/// It abstracts the location and characteristics of SMRAM. The expectation is\r
-/// that the north bridge or memory controller would publish this protocol.\r
-/// \r
-struct _EFI_SMM_ACCESS2_PROTOCOL {\r
- EFI_SMM_OPEN2 Open;\r
- EFI_SMM_CLOSE2 Close;\r
- EFI_SMM_LOCK2 Lock;\r
- EFI_SMM_CAPABILITIES2 GetCapabilities;\r
- ///\r
- /// Indicates the current state of the SMRAM. Set to TRUE if SMRAM is locked.\r
- ///\r
- BOOLEAN LockState;\r
- ///\r
- /// Indicates the current state of the SMRAM. Set to TRUE if SMRAM is open.\r
- ///\r
- BOOLEAN OpenState;\r
-};\r