From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail02.groups.io (mail02.groups.io [66.175.222.108]) by spool.mail.gandi.net (Postfix) with ESMTPS id 28AED941839 for ; Thu, 20 Jul 2023 21:07:38 +0000 (UTC) DKIM-Signature: a=rsa-sha256; bh=m20RfqiKZpeZCpiphGFd8YGV+BdiAjnQpZX4yqSny98=; c=relaxed/simple; d=groups.io; h=X-Received:X-Received:X-Received:X-Gm-Message-State:X-Google-Smtp-Source:X-Received:X-Received:From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References:MIME-Version:Precedence:List-Subscribe:List-Help:Sender:List-Id:Mailing-List:Delivered-To:Reply-To:List-Unsubscribe-Post:List-Unsubscribe:Content-Transfer-Encoding; s=20140610; t=1689887256; v=1; b=hyfF2UKyB0AFFGyrLOy5/jDcM3WKTW0AF5fhmuFXazH8mXOEvDJa1JLSJfVb0RwkW2Mm9bbe /ETqrrJIqpGQ/6bhT+y02gydi+xHvmCA9YIsM0RinwbmwTu45aW4bRWRCB5duhHjtNf4zyy/sb/ cCsl7fIV04hm6V2CqXAwE/dQ= X-Received: by 127.0.0.2 with SMTP id sU7LYY7687511xEPkgFeTotS; Thu, 20 Jul 2023 14:07:36 -0700 X-Received: from mail-pf1-f178.google.com (mail-pf1-f178.google.com [209.85.210.178]) by mx.groups.io with SMTP id smtpd.web10.1787.1689887256113910598 for ; Thu, 20 Jul 2023 14:07:36 -0700 X-Received: by mail-pf1-f178.google.com with SMTP id d2e1a72fcca58-668730696a4so866675b3a.1 for ; Thu, 20 Jul 2023 14:07:36 -0700 (PDT) X-Gm-Message-State: qAYTy9hjDpH5tDuXwctu4mgRx7686176AA= X-Google-Smtp-Source: APBJJlGXkKyJ+bL5TXN7XgmyBaFroK92vkuYW4N4iS78FFYzkvhjDrfPlv3njxskb+XtB7F3Cg243g== X-Received: by 2002:a05:6a20:4f26:b0:115:5ed5:34d3 with SMTP id gi38-20020a056a204f2600b001155ed534d3mr63615pzb.20.1689887255346; Thu, 20 Jul 2023 14:07:35 -0700 (PDT) X-Received: from MININT-0U7P5GU.redmond.corp.microsoft.com ([2001:4898:80e8:37:e07c:3f9b:2f13:3c64]) by smtp.gmail.com with ESMTPSA id d1-20020a170902aa8100b001b9ecee9f81sm1855943plr.129.2023.07.20.14.07.34 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 20 Jul 2023 14:07:35 -0700 (PDT) From: "Kun Qin" To: devel@edk2.groups.io Cc: Michael D Kinney , Liming Gao , Zhiguang Liu , Mike Turner Subject: [edk2-devel] [PATCH v1 2/4] MdePkg: DelayedDispatch: Added WaitOnEvent interface Date: Thu, 20 Jul 2023 14:07:26 -0700 Message-ID: <20230720210729.774-3-kuqin12@gmail.com> In-Reply-To: <20230720210729.774-1-kuqin12@gmail.com> References: <20230720210729.774-1-kuqin12@gmail.com> MIME-Version: 1.0 Precedence: Bulk 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 List-Unsubscribe-Post: List-Unsubscribe=One-Click List-Unsubscribe: Content-Transfer-Encoding: quoted-printable X-GND-Status: LEGIT Authentication-Results: spool.mail.gandi.net; dkim=pass header.d=groups.io header.s=20140610 header.b=hyfF2UKy; dmarc=fail reason="SPF not aligned (relaxed), DKIM not aligned (relaxed)" header.from=gmail.com (policy=none); spf=pass (spool.mail.gandi.net: domain of bounce@groups.io designates 66.175.222.108 as permitted sender) smtp.mailfrom=bounce@groups.io REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3D4496 This change adds a new interface for the delayed dispatch PPI. This new addition allows functional components relying on delayed dispatch callbacks to be managed/dispatched with definitive order. The full defintion has been added into PI spec. Cc: Michael D Kinney Cc: Liming Gao Cc: Zhiguang Liu Co-authored-by: Mike Turner Signed-off-by: Kun Qin --- MdePkg/Include/Ppi/DelayedDispatch.h | 24 +++++++++++++++++++- 1 file changed, 23 insertions(+), 1 deletion(-) diff --git a/MdePkg/Include/Ppi/DelayedDispatch.h b/MdePkg/Include/Ppi/Dela= yedDispatch.h index 098d57758551..253cafd46d28 100644 --- a/MdePkg/Include/Ppi/DelayedDispatch.h +++ b/MdePkg/Include/Ppi/DelayedDispatch.h @@ -50,6 +50,7 @@ This service is the single member function of the EFI_DEL= AYED_DISPATCH_PPI @param[in] This Pointer to the EFI_DELAYED_DISPATCH_PPI instan= ce=0D @param[in] Function Function to call back=0D @param[in] Context Context data=0D + @param[in] UniqueId GUID for this Delayed Dispatch request.=0D @param[in] Delay Delay interval=0D =0D @retval EFI_SUCCESS Function successfully loaded=0D @@ -63,9 +64,29 @@ EFI_STATUS IN EFI_DELAYED_DISPATCH_PPI *This,=0D IN EFI_DELAYED_DISPATCH_FUNCTION Function,=0D IN UINT64 Context,=0D + IN EFI_GUID *UniqueId OPTIONAL,=0D IN UINT32 Delay=0D );=0D =0D +/**=0D + Wait on a registered Delayed Dispatch unit that has a UniqueId. Continu= e=0D + to dispatch all registered delayed dispatch entries until *ALL* entries = with=0D + UniqueId have completed.=0D +=0D + @param[in] This The Delayed Dispatch PPI pointer.=0D + @param[in] UniqueId UniqueId of delayed dispatch entry.=0D +=0D + @retval EFI_SUCCESS The operation succeeds.=0D + @retval EFI_INVALID_PARAMETER The parameters are invalid.=0D +=0D +**/=0D +typedef=0D +EFI_STATUS=0D +(EFIAPI *EFI_DELAYED_DISPATCH_WAIT_ON_EVENT)(=0D + IN EFI_DELAYED_DISPATCH_PPI *This,=0D + IN EFI_GUID *UniqueId=0D + );=0D +=0D ///=0D /// This PPI is a pointer to the Delayed Dispatch Service.=0D /// This service will be published by the Pei Foundation. The PEI Foundati= on=0D @@ -73,7 +94,8 @@ EFI_STATUS /// execution.=0D ///=0D struct _EFI_DELAYED_DISPATCH_PPI {=0D - EFI_DELAYED_DISPATCH_REGISTER Register;=0D + EFI_DELAYED_DISPATCH_REGISTER Register;=0D + EFI_DELAYED_DISPATCH_WAIT_ON_EVENT WaitOnEvent;=0D };=0D =0D extern EFI_GUID gEfiPeiDelayedDispatchPpiGuid;=0D --=20 2.41.0.windows.2 -=-=-=-=-=-=-=-=-=-=-=- Groups.io Links: You receive all messages sent to this group. View/Reply Online (#107113): https://edk2.groups.io/g/devel/message/107113 Mute This Topic: https://groups.io/mt/100264777/7686176 Group Owner: devel+owner@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/unsub [rebecca@openfw.io] -=-=-=-=-=-=-=-=-=-=-=-