From nobody Mon Feb 9 09:33:49 2026 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of groups.io designates 66.175.222.108 as permitted sender) client-ip=66.175.222.108; envelope-from=bounce+27952+85312+1787277+3901457@groups.io; helo=mail02.groups.io; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.108 as permitted sender) smtp.mailfrom=bounce+27952+85312+1787277+3901457@groups.io; dmarc=fail(p=none dis=none) header.from=gmail.com ARC-Seal: i=1; a=rsa-sha256; t=1641521748; cv=none; d=zohomail.com; s=zohoarc; b=TW2VPjVORzXs5/xdY0gR8wHwpPnI9IHzKMiHSvFAZ/Bf0+DmZz5vYQgxLNmPj9Ebti4Dras1Ya/SQxAKc6RRcTvGQfcNIAkK6puL21b4PLgJBdYarpF3FjkKzhN8DTPaxRybl2LiHnC9dbS1CeTQZ9u5J67y6Dy5rs5jytz8evA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1641521748; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Subscribe:List-Id:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Reply-To:References:Sender:Subject:To; bh=rVEwjzR0IlgIUjFldRDIq74et+9m9VoeUDLapaGJZQ0=; b=b3hA/8qtyh2BMaCTbOMI2guyk2PDK8Q6ngrXip4YQMXD+rPH2obeuxvYv23J8T9izbNZSrbH9OMJJPyRUIXYxGqu8YQ5647YzqzimbLOR7BlmYMtNkFprS2yaxwq7oD2NG1O8Tl5POr1w/hRi9g2RBZVbnO8cLQEqi3N/X9oEvA= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.108 as permitted sender) smtp.mailfrom=bounce+27952+85312+1787277+3901457@groups.io; dmarc=fail header.from= (p=none dis=none) Received: from mail02.groups.io (mail02.groups.io [66.175.222.108]) by mx.zohomail.com with SMTPS id 1641521748456708.0398964727112; Thu, 6 Jan 2022 18:15:48 -0800 (PST) Return-Path: X-Received: by 127.0.0.2 with SMTP id 5UyBYY1788612xRBTEZSYep4; Thu, 06 Jan 2022 18:15:48 -0800 X-Received: from mail-pg1-f174.google.com (mail-pg1-f174.google.com [209.85.215.174]) by mx.groups.io with SMTP id smtpd.web11.1479.1641521747425755944 for ; Thu, 06 Jan 2022 18:15:47 -0800 X-Received: by mail-pg1-f174.google.com with SMTP id g2so4171519pgo.9 for ; Thu, 06 Jan 2022 18:15:47 -0800 (PST) X-Gm-Message-State: OvLxfKOjyfhImTGEt23ImFu3x1787277AA= X-Google-Smtp-Source: ABdhPJz9swZccxr0nF/LjaiKHS/VaekeIq+HCMwvtC4g/2yrQhmHOHP0MMfCT+nOgvLH8HXSUK29Rg== X-Received: by 2002:a05:6a00:2401:b0:4bb:45fc:7829 with SMTP id z1-20020a056a00240100b004bb45fc7829mr63568406pfh.38.1641521746389; Thu, 06 Jan 2022 18:15:46 -0800 (PST) X-Received: from localhost.localdomain ([50.35.74.198]) by smtp.gmail.com with ESMTPSA id j3sm3894875pfc.196.2022.01.06.18.15.45 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 06 Jan 2022 18:15:46 -0800 (PST) From: "Kun Qin" To: devel@edk2.groups.io Cc: Michael D Kinney , Liming Gao , Zhiguang Liu , Hao A Wu , =?UTF-8?q?Marvin=20H=C3=A4user?= , Bret Barkelew , Michael Kubacki Subject: [edk2-devel] [PATCH v4 4/7] MdePkg: MmCommunication: Introduce EFI_PEI_MM_COMMUNICATION3_PPI to MdePkg Date: Thu, 6 Jan 2022 18:15:29 -0800 Message-Id: <20220107021532.1322-5-kuqin12@gmail.com> In-Reply-To: <20220107021532.1322-1-kuqin12@gmail.com> References: <20220107021532.1322-1-kuqin12@gmail.com> MIME-Version: 1.0 Precedence: Bulk List-Unsubscribe: List-Subscribe: List-Help: Sender: devel@edk2.groups.io List-Id: Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io Reply-To: devel@edk2.groups.io,kuqin12@gmail.com Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1641521748; bh=3tdh2zqL4tTSPulVpU8nQGEdt9TTX8QEX6hZBB5OBJI=; h=Cc:Content-Type:Date:From:Reply-To:Subject:To; b=AlsrK8uo3PPbXVHIYDLlfRJsTZv1IxpYIEZN/iShnfH5NkzP1GAh0c8Hun6xPqIeF1l sfdCOYkmEeP1yEecidlAPBmqcTj8adZIxdyDPLVtsIpGZQq8nw8ogqg3UZ9zoZkC0z2Ut px9WPlJ/rZG5VPgAJi4yAScrPRh43QT6hRs= X-ZohoMail-DKIM: pass (identity @groups.io) X-ZM-MESSAGEID: 1641521750495100018 REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3D3398 REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3D3430 This change introduces a new definition for MM communicate PPI v3. This PPI will be installed under a new GUID in contrast to exisiting EFI_PEI_MM_COMMUNICATION_PPI. Data communicated to MM through EFI_PEI_MM_COMMUNICATION3_PPI should always start with EFI_MM_COMMUNICATE_HEADER_V3 with its HeaderGuid, Signature and Version fields properly populated. Cc: Michael D Kinney Cc: Liming Gao Cc: Zhiguang Liu Cc: Hao A Wu Cc: Marvin H=C3=A4user Cc: Bret Barkelew Cc: Michael Kubacki Signed-off-by: Kun Qin --- Notes: v3: - Newly introduced v3 communicate PPI =20 v4: - Rebased with uncrustify changes. MdePkg/Include/Ppi/MmCommunication3.h | 57 ++++++++++++++++++++ MdePkg/MdePkg.dec | 3 ++ 2 files changed, 60 insertions(+) diff --git a/MdePkg/Include/Ppi/MmCommunication3.h b/MdePkg/Include/Ppi/MmC= ommunication3.h new file mode 100644 index 000000000000..1cc75c38c012 --- /dev/null +++ b/MdePkg/Include/Ppi/MmCommunication3.h @@ -0,0 +1,57 @@ +/** @file + EFI MM Communication v3 PPI definition. + + This Ppi provides a means of communicating between PEIM and MMI + handlers inside of MM. + +Copyright (c) 2010 - 2018, Intel Corporation. All rights reserved.
+Copyright (c) Microsoft Corporation. + +SPDX-License-Identifier: BSD-2-Clause-Patent + +**/ + +#ifndef MM_COMMUNICATION3_PPI_H_ +#define MM_COMMUNICATION3_PPI_H_ + +#include + +#define EFI_PEI_MM_COMMUNICATION3_PPI_GUID \ + { \ + 0xe70febf6, 0x13ef, 0x4a21, { 0x89, 0x9e, 0xb2, 0x36, 0xf8, 0x25, 0xff= , 0xc9 } \ + } + +typedef struct _EFI_PEI_MM_COMMUNICATION3_PPI EFI_PEI_MM_COMMUNICATION3_PP= I; + +/** + Communicates with a registered handler. + + This function provides a service to send and receive messages from a reg= istered UEFI service. + + @param[in] This The EFI_PEI_MM_COMMUNICATE3 instance. + @param[in, out] CommBuffer A pointer to the buffer to convey into MM= RAM. + @param[in, out] CommSize The size of the data buffer being passed = in.On exit, the size of data + being returned. Zero if the handler does = not wish to reply with any data. + + @retval EFI_SUCCESS The message was successfully posted. + @retval EFI_INVALID_PARAMETER The CommBuffer was NULL. +**/ +typedef +EFI_STATUS +(EFIAPI *EFI_PEI_MM_COMMUNICATE3)( + IN CONST EFI_PEI_MM_COMMUNICATION3_PPI *This, + IN OUT VOID *CommBuffer, + IN OUT UINTN *CommSize + ); + +/// +/// EFI MM Communication PPI provides runtime services for communicating +/// between DXE drivers and a registered SMI handler. +/// +struct _EFI_PEI_MM_COMMUNICATION3_PPI { + EFI_PEI_MM_COMMUNICATE3 Communicate; +}; + +extern EFI_GUID gEfiPeiMmCommunication3PpiGuid; + +#endif diff --git a/MdePkg/MdePkg.dec b/MdePkg/MdePkg.dec index 8c61661e4ee7..cb42078fa330 100644 --- a/MdePkg/MdePkg.dec +++ b/MdePkg/MdePkg.dec @@ -1012,6 +1012,9 @@ [Ppis] ## Include/Ppi/DelayedDispatch.h gEfiPeiDelayedDispatchPpiGuid =3D { 0x869c711d, 0x649c, 0x44fe, { 0x8b,= 0x9e, 0x2c, 0xbb, 0x29, 0x11, 0xc3, 0xe6 }} =20 + ## Include/Ppi/MmCommunication3.h + gEfiPeiMmCommunication3PpiGuid =3D { 0xe70febf6, 0x13ef, 0x4a21, { 0x89,= 0x9e, 0xb2, 0x36, 0xf8, 0x25, 0xff, 0xc9 }} + [Protocols] ## Include/Protocol/Pcd.h gPcdProtocolGuid =3D { 0x11B34006, 0xD85B, 0x4D0A, { 0xA2,= 0x90, 0xD5, 0xA5, 0x71, 0x31, 0x0E, 0xF7 }} --=20 2.34.1.windows.1 -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- Groups.io Links: You receive all messages sent to this group. View/Reply Online (#85312): https://edk2.groups.io/g/devel/message/85312 Mute This Topic: https://groups.io/mt/88253683/1787277 Group Owner: devel+owner@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/unsub [importer@patchew.org] -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-