From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga01.intel.com (mga01.intel.com [192.55.52.88]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ml01.01.org (Postfix) with ESMTPS id 594B121945DF3 for ; Thu, 29 Jun 2017 07:09:12 -0700 (PDT) Received: from orsmga004.jf.intel.com ([10.7.209.38]) by fmsmga101.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 29 Jun 2017 07:10:44 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.40,281,1496127600"; d="scan'208";a="102758279" Received: from fmsmsx106.amr.corp.intel.com ([10.18.124.204]) by orsmga004.jf.intel.com with ESMTP; 29 Jun 2017 07:10:44 -0700 Received: from fmsmsx156.amr.corp.intel.com (10.18.116.74) by FMSMSX106.amr.corp.intel.com (10.18.124.204) with Microsoft SMTP Server (TLS) id 14.3.319.2; Thu, 29 Jun 2017 07:10:44 -0700 Received: from shsmsx103.ccr.corp.intel.com (10.239.4.69) by fmsmsx156.amr.corp.intel.com (10.18.116.74) with Microsoft SMTP Server (TLS) id 14.3.319.2; Thu, 29 Jun 2017 07:10:43 -0700 Received: from shsmsx102.ccr.corp.intel.com ([169.254.2.146]) by SHSMSX103.ccr.corp.intel.com ([169.254.4.116]) with mapi id 14.03.0319.002; Thu, 29 Jun 2017 22:10:42 +0800 From: "Zeng, Star" To: "Ni, Ruiyu" , "edk2-devel@lists.01.org" CC: "Gao, Liming" , "Zeng, Star" Thread-Topic: [edk2] [PATCH 1/3] MdePkg: Add ResetNotification protocol definition Thread-Index: AQHS8LJOH05lzsYciEKos39OzpkOQqI74YDQ Date: Thu, 29 Jun 2017 14:10:41 +0000 Message-ID: <0C09AFA07DD0434D9E2A0C6AEB0483103B8EFFB0@shsmsx102.ccr.corp.intel.com> References: <20170629083221.485184-1-ruiyu.ni@intel.com> <20170629083221.485184-2-ruiyu.ni@intel.com> In-Reply-To: <20170629083221.485184-2-ruiyu.ni@intel.com> Accept-Language: zh-CN, en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: dlp-product: dlpe-windows dlp-version: 10.0.102.7 dlp-reaction: no-action x-originating-ip: [10.239.127.40] MIME-Version: 1.0 Subject: Re: [PATCH 1/3] MdePkg: Add ResetNotification protocol definition X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.22 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 29 Jun 2017 14:09:12 -0000 Content-Language: en-US Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable Reviewed-by: Star Zeng -----Original Message----- From: edk2-devel [mailto:edk2-devel-bounces@lists.01.org] On Behalf Of Ruiy= u Ni Sent: Thursday, June 29, 2017 4:32 PM To: edk2-devel@lists.01.org Cc: Gao, Liming Subject: [edk2] [PATCH 1/3] MdePkg: Add ResetNotification protocol definiti= on Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Ruiyu Ni Cc: Liming Gao --- MdePkg/Include/Protocol/ResetNotification.h | 86 +++++++++++++++++++++++++= ++++ MdePkg/MdePkg.dec | 3 + 2 files changed, 89 insertions(+) create mode 100644 MdePkg/Include/Protocol/ResetNotification.h diff --git a/MdePkg/Include/Protocol/ResetNotification.h b/MdePkg/Include/P= rotocol/ResetNotification.h new file mode 100644 index 0000000000..ade0eee34a --- /dev/null +++ b/MdePkg/Include/Protocol/ResetNotification.h @@ -0,0 +1,86 @@ +/** @file + EFI Reset Notification Protocol as defined in UEFI 2.7. + This protocol provides services to register for a notification when Rese= tSystem is called. + + Copyright (c) 2017, Intel Corporation. All rights reserved.
This=20 + program and the accompanying materials are licensed and made available=20 + under the terms and conditions of the BSD License that accompanies this = distribution. + The full text of the license may be found at =20 + http://opensource.org/licenses/bsd-license.php. + + THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, =20 + WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPL= IED. + + @par Revision Reference: + This Protocol is introduced in UEFI Specification 2.7 + +**/ + +#ifndef __EFI_RESET_NOTIFICATION_H__ +#define __EFI_RESET_NOTIFICATION_H__ + +#define EFI_RESET_NOTIFICATION_PROTOCOL_GUID \ + { 0x9da34ae0, 0xeaf9, 0x4bbf, { 0x8e, 0xc3, 0xfd, 0x60, 0x22, 0x6c,=20 +0x44, 0xbe } } + +typedef struct _EFI_RESET_NOTIFICATION_PROTOCOL=20 +EFI_RESET_NOTIFICATION_PROTOCOL; + +/** + Register a notification function to be called when ResetSystem() is call= ed. + + The RegisterResetNotify() function registers a notification function=20 + that is called when ResetSystem()is called and prior to completing the r= eset of the platform. + The registered functions must not perform a platform reset=20 + themselves. These notifications are intended only for the=20 + notification of components which may need some special-purpose maintenan= ce prior to the platform resetting. + The list of registered reset notification functions are processed if=20 + ResetSystem()is called before ExitBootServices(). The list of=20 + registered reset notification functions is ignored if ResetSystem()is ca= lled after ExitBootServices(). + + @param[in] This A pointer to the EFI_RESET_NOTIFICATION_PR= OTOCOL instance. + @param[in] ResetFunction Points to the function to be called when a= ResetSystem() is executed. + + @retval EFI_SUCCESS The reset notification function was succes= sfully registered. + @retval EFI_INVALID_PARAMETER ResetFunction is NULL. + @retval EFI_OUT_OF_RESOURCES There are not enough resources available t= o register the reset notification function. + @retval EFI_ALREADY_STARTED The reset notification function specified = by ResetFunction has already been registered. + +**/ +typedef +EFI_STATUS +(EFIAPI *EFI_REGISTER_RESET_NOTIFY) ( + IN EFI_RESET_NOTIFICATION_PROTOCOL *This, + IN EFI_RESET_SYSTEM ResetFunction +); + +/** + Unregister a notification function. + + The UnregisterResetNotify() function removes the previously=20 + registered notification using RegisterResetNotify(). + + @param[in] This A pointer to the EFI_RESET_NOTIFICATION_PR= OTOCOL instance. + @param[in] ResetFunction The pointer to the ResetFunction being unr= egistered. + + @retval EFI_SUCCESS The reset notification function was unregi= stered. + @retval EFI_INVALID_PARAMETER ResetFunction is NULL. + @retval EFI_INVALID_PARAMETER The reset notification function specified = by ResetFunction was not previously + registered using RegisterResetNotify(). + +**/ +typedef +EFI_STATUS +(EFIAPI *EFI_UNREGISTER_RESET_NOTIFY) ( + IN EFI_RESET_NOTIFICATION_PROTOCOL *This, + IN EFI_RESET_SYSTEM ResetFunction +); + +typedef struct _EFI_RESET_NOTIFICATION_PROTOCOL { + EFI_REGISTER_RESET_NOTIFY RegisterResetNotify; + EFI_UNREGISTER_RESET_NOTIFY UnRegisterResetNotify; }=20 +EFI_RESET_NOTIFICATION_PROTOCOL; + + +extern EFI_GUID gEfiResetNotificationProtocolGuid; + +#endif + diff --git a/MdePkg/MdePkg.dec b/MdePkg/MdePkg.dec index 4abbbd8888..2bdfeb= f36f 100644 --- a/MdePkg/MdePkg.dec +++ b/MdePkg/MdePkg.dec @@ -1669,6 +1669,9 @@ [Protocols] ## Include/Protocol/HttpBootCallback.h gEfiHttpBootCallbackProtocolGuid =3D {0xba23b311, 0x343d, 0x11e6, {0x9= 1, 0x85, 0x58, 0x20, 0xb1, 0xd6, 0x52, 0x99}} =20 + ## Include/Protocol/ResetNotification.h + gEfiResetNotificationProtocolGuid =3D { 0x9da34ae0, 0xeaf9, 0x4b= bf, { 0x8e, 0xc3, 0xfd, 0x60, 0x22, 0x6c, 0x44, 0xbe } } + # # Protocols defined in Shell2.0 # -- 2.12.2.windows.2 _______________________________________________ edk2-devel mailing list edk2-devel@lists.01.org https://lists.01.org/mailman/listinfo/edk2-devel