From nobody Thu Dec 26 13:36:11 2024 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; spf=none (zoho.com: 198.145.21.10 is neither permitted nor denied by domain of lists.01.org) smtp.mailfrom=edk2-devel-bounces@lists.01.org Return-Path: Received: from ml01.01.org (ml01.01.org [198.145.21.10]) by mx.zohomail.com with SMTPS id 1506577317548950.1528021815811; Wed, 27 Sep 2017 22:41:57 -0700 (PDT) Received: from [127.0.0.1] (localhost [IPv6:::1]) by ml01.01.org (Postfix) with ESMTP id 1751621EC8D1D; Wed, 27 Sep 2017 22:38:41 -0700 (PDT) Received: from mga02.intel.com (mga02.intel.com [134.134.136.20]) (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 97F3421EC8D17 for ; Wed, 27 Sep 2017 22:38:39 -0700 (PDT) Received: from fmsmga005.fm.intel.com ([10.253.24.32]) by orsmga101.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 27 Sep 2017 22:41:53 -0700 Received: from jiaxinwu-mobl2.ccr.corp.intel.com ([10.239.196.220]) by fmsmga005.fm.intel.com with ESMTP; 27 Sep 2017 22:41:52 -0700 X-Original-To: edk2-devel@lists.01.org Received-SPF: none (zoho.com: 198.145.21.10 is neither permitted nor denied by domain of lists.01.org) client-ip=198.145.21.10; envelope-from=edk2-devel-bounces@lists.01.org; helo=ml01.01.org; Received-SPF: Pass (sender SPF authorized) identity=mailfrom; client-ip=134.134.136.20; helo=mga02.intel.com; envelope-from=jiaxin.wu@intel.com; receiver=edk2-devel@lists.01.org X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.42,448,1500966000"; d="scan'208";a="156425589" From: Jiaxin Wu To: edk2-devel@lists.01.org Date: Thu, 28 Sep 2017 13:41:49 +0800 Message-Id: <1506577310-40432-2-git-send-email-jiaxin.wu@intel.com> X-Mailer: git-send-email 1.9.5.msysgit.1 In-Reply-To: <1506577310-40432-1-git-send-email-jiaxin.wu@intel.com> References: <1506577310-40432-1-git-send-email-jiaxin.wu@intel.com> Subject: [edk2] [Patch 1/2] MdePkg/Http.h: Clarify the usage of HttpConfigData in HTTP protocol 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: , Cc: Ye Ting , Fu Siyuan , Wu Jiaxin MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Errors-To: edk2-devel-bounces@lists.01.org Sender: "edk2-devel" X-ZohoMail: RSF_4 Z_629925259 SPT_0 Content-Type: text/plain; charset="utf-8" Cc: Ye Ting Cc: Fu Siyuan Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Wu Jiaxin --- MdePkg/Include/Protocol/Http.h | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/MdePkg/Include/Protocol/Http.h b/MdePkg/Include/Protocol/Http.h index 297d9c3..bdcd7b1 100644 --- a/MdePkg/Include/Protocol/Http.h +++ b/MdePkg/Include/Protocol/Http.h @@ -303,19 +303,21 @@ typedef struct { The GetModeData() function is used to read the current mode data (operat= ional parameters) for this HTTP protocol instance. =20 @param[in] This Pointer to EFI_HTTP_PROTOCOL instance. @param[out] HttpConfigData Point to buffer for operational paramete= rs of this - HTTP instance. + HTTP instance. It is the responsibility = of the caller=20 + to allocate the memory for HttpConfigDat= a and=20 + HttpConfigData->AccessPoint.IPv6Node/IPv= 4Node. In fact,=20 + it is recommended to allocate sufficient= memory to record=20 + IPv6Node since it is big enough for all = possibilities. =20 @retval EFI_SUCCESS Operation succeeded. @retval EFI_INVALID_PARAMETER This is NULL. HttpConfigData is NULL. - HttpInstance->LocalAddressIsIPv6 is FALS= E and - HttpConfigData->IPv4Node is NULL. - HttpInstance->LocalAddressIsIPv6 is TRUE= and - HttpConfigData->IPv6Node is NULL. + HttpConfigData->AccessPoint.IPv4Node or=20 + HttpConfigData->AccessPoint.IPv6Node is = NULL. @retval EFI_NOT_STARTED This EFI HTTP Protocol instance has not = been started. **/ typedef EFI_STATUS (EFIAPI *EFI_HTTP_GET_MODE_DATA)( @@ -341,13 +343,13 @@ EFI_STATUS =20 @retval EFI_SUCCESS Operation succeeded. @retval EFI_INVALID_PARAMETER One or more of the following conditions = is TRUE: This is NULL. HttpConfigData->LocalAddressIsIPv6 is FA= LSE and - HttpConfigData->IPv4Node is NULL. + HttpConfigData->AccessPoint.IPv4Node is = NULL. HttpConfigData->LocalAddressIsIPv6 is TR= UE and - HttpConfigData->IPv6Node is NULL. + HttpConfigData->AccessPoint.IPv6Node is = NULL. @retval EFI_ALREADY_STARTED Reinitialize this HTTP instance without = calling Configure() with NULL to reset it. @retval EFI_DEVICE_ERROR An unexpected system or network error oc= curred. @retval EFI_OUT_OF_RESOURCES Could not allocate enough system resourc= es when executing Configure(). --=20 1.9.5.msysgit.1 _______________________________________________ edk2-devel mailing list edk2-devel@lists.01.org https://lists.01.org/mailman/listinfo/edk2-devel