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 7457ED80A14 for ; Thu, 28 Dec 2023 07:53:55 +0000 (UTC) DKIM-Signature: a=rsa-sha256; bh=6afRuyl/4r7G6woYsEMLeT8NPRuJ3ZZsMc8QTt7d3l8=; c=relaxed/simple; d=groups.io; h=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=1703750033; v=1; b=iiMZ70OLHZwQTbJWAy0m82MMHy54nhXId2JI5uvhk+OIgV8HaLq6kVxZgczKY9vpHH2/riDr mPKIBAwQWcqgu5x40uiHIdr1fw7tVZ+T7ZYR0ZirSTMyk8SdvTEt/2WSC8x4525e8NtrRAwjYx5 Z4XUHNCCMskB9FuymOKuJQsE= X-Received: by 127.0.0.2 with SMTP id 3HvyYY7687511xWpkob4mJrS; Wed, 27 Dec 2023 23:53:53 -0800 X-Received: from mgamail.intel.com (mgamail.intel.com [192.198.163.10]) by mx.groups.io with SMTP id smtpd.web11.119090.1703750033032677579 for ; Wed, 27 Dec 2023 23:53:53 -0800 X-IronPort-AV: E=McAfee;i="6600,9927,10936"; a="3821359" X-IronPort-AV: E=Sophos;i="6.04,311,1695711600"; d="scan'208";a="3821359" X-Received: from fmsmga008.fm.intel.com ([10.253.24.58]) by fmvoesa104.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 27 Dec 2023 23:53:49 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6600,9927,10936"; a="844376418" X-IronPort-AV: E=Sophos;i="6.04,311,1695711600"; d="scan'208";a="844376418" X-Received: from shclienthost01.ccr.corp.intel.com ([10.239.216.139]) by fmsmga008.fm.intel.com with ESMTP; 27 Dec 2023 23:53:47 -0800 From: "Junfeng Guan" To: devel@edk2.groups.io Cc: Michael D Kinney , Liming Gao , Zhiguang Liu , Yi Li Subject: [edk2-devel] [PATCH 1/1] MdePkg: Update GetHealthStatus function description Date: Thu, 28 Dec 2023 15:53:44 +0800 Message-Id: <798578429cd1a0f5fa8b9ede43fc6b3a7e1684ce.1703749992.git.junfengx.guan@intel.com> In-Reply-To: References: 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,junfengx.guan@intel.com List-Unsubscribe-Post: List-Unsubscribe=One-Click List-Unsubscribe: X-Gm-Message-State: 2KbJCiqyrYrlpMEbYu0rJCV2x7686176AA= Content-Transfer-Encoding: 8bit X-GND-Status: LEGIT Authentication-Results: spool.mail.gandi.net; dkim=pass header.d=groups.io header.s=20140610 header.b=iiMZ70OL; spf=pass (spool.mail.gandi.net: domain of bounce@groups.io designates 66.175.222.108 as permitted sender) smtp.mailfrom=bounce@groups.io; dmarc=fail reason="SPF not aligned (relaxed), DKIM not aligned (relaxed)" header.from=intel.com (policy=none) Refer to Uefi spec 2.10 section 11.10.2, update the return value for EFI_DRIVER_HEALTH_PROTOCOL.GetHealthStatus. Signed-off-by: Junfeng Guan Cc: Michael D Kinney Cc: Liming Gao Cc: Zhiguang Liu Cc: Yi Li --- MdePkg/Include/Protocol/DriverHealth.h | 32 +++++++------------------- 1 file changed, 8 insertions(+), 24 deletions(-) diff --git a/MdePkg/Include/Protocol/DriverHealth.h b/MdePkg/Include/Protocol/DriverHealth.h index 9de025434ef3..9e1bd903f4be 100644 --- a/MdePkg/Include/Protocol/DriverHealth.h +++ b/MdePkg/Include/Protocol/DriverHealth.h @@ -137,35 +137,19 @@ EFI_STATUS will only be returned with a HealthStatus value of EfiDriverHealthStatusConfigurationRequired. - @retval EFI_SUCCESS ControllerHandle is NULL, and all the controllers - managed by this driver specified by This have a health - status of EfiDriverHealthStatusHealthy with no warning - messages to be returned. The ChildHandle, HealthStatus, - MessageList, and FormList parameters are ignored. - - @retval EFI_DEVICE_ERROR ControllerHandle is NULL, and one or more of the - controllers managed by this driver specified by This - do not have a health status of EfiDriverHealthStatusHealthy. - The ChildHandle, HealthStatus, MessageList, and - FormList parameters are ignored. - - @retval EFI_DEVICE_ERROR ControllerHandle is NULL, and one or more of the - controllers managed by this driver specified by This - have one or more warning and/or error messages. - The ChildHandle, HealthStatus, MessageList, and - FormList parameters are ignored. - - @retval EFI_SUCCESS ControllerHandle is not NULL and the health status - of the controller specified by ControllerHandle and - ChildHandle was returned in HealthStatus. A list - of warning and error messages may be optionally - returned in MessageList, and a list of HII Forms - may be optionally returned in FormList. + @retval EFI_SUCCESS The health status of the controller specified by + ControllerHandle and ChildHandle was returned in HealthStatus. + A list of warning and error messages may be optionally + returned in MessageList, and an HII Form may be optionally + specified by FormHiiHandle. @retval EFI_UNSUPPORTED ControllerHandle is not NULL, and the controller specified by ControllerHandle and ChildHandle is not currently being managed by the driver specified by This. + @retval EFI_UNSUPPORTED ControllerHandle is NULL and there are no devices being + managed by the driver. + @retval EFI_INVALID_PARAMETER HealthStatus is NULL. @retval EFI_OUT_OF_RESOURCES MessageList is not NULL, and there are not enough -- 2.26.2.windows.1 -=-=-=-=-=-=-=-=-=-=-=- Groups.io Links: You receive all messages sent to this group. View/Reply Online (#112943): https://edk2.groups.io/g/devel/message/112943 Mute This Topic: https://groups.io/mt/103397828/7686176 Group Owner: devel+owner@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/unsub [rebecca@openfw.io] -=-=-=-=-=-=-=-=-=-=-=-