From nobody Thu May 2 05:51:28 2024 Delivered-To: importer@patchew.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; Authentication-Results: mx.zoho.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 1497847622266978.7170924561794; Sun, 18 Jun 2017 21:47:02 -0700 (PDT) Received: from [127.0.0.1] (localhost [IPv6:::1]) by ml01.01.org (Postfix) with ESMTP id B24AE21C8F632; Sun, 18 Jun 2017 21:45:37 -0700 (PDT) Received: from mga09.intel.com (mga09.intel.com [134.134.136.24]) (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 2E00221962336 for ; Sun, 18 Jun 2017 21:45:37 -0700 (PDT) Received: from orsmga002.jf.intel.com ([10.7.209.21]) by orsmga102.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 18 Jun 2017 21:46:58 -0700 Received: from shwdeopenpsi114.ccr.corp.intel.com ([10.239.157.135]) by orsmga002.jf.intel.com with ESMTP; 18 Jun 2017 21:46:57 -0700 X-Original-To: edk2-devel@lists.01.org X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.39,359,1493708400"; d="scan'208";a="100987124" From: Dandan Bi To: edk2-devel@lists.01.org Date: Mon, 19 Jun 2017 12:46:19 +0800 Message-Id: <1497847586-18144-2-git-send-email-dandan.bi@intel.com> X-Mailer: git-send-email 1.9.5.msysgit.1 In-Reply-To: <1497847586-18144-1-git-send-email-dandan.bi@intel.com> References: <1497847586-18144-1-git-send-email-dandan.bi@intel.com> Subject: [edk2] [PATCH v2 1/8] MdePkg/SimpleTextInEx: Update comments according to UEFI 2.7 spec 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: Ruiyu Ni , Star Zeng , Liming Gao 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: Liming Gao Cc: Star Zeng Cc: Ruiyu Ni Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Dandan Bi Reviewed-by: Star Zeng to this patch series. --- MdePkg/Include/Protocol/SimpleTextInEx.h | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/MdePkg/Include/Protocol/SimpleTextInEx.h b/MdePkg/Include/Prot= ocol/SimpleTextInEx.h index 436ff37..4591bd4 100644 --- a/MdePkg/Include/Protocol/SimpleTextInEx.h +++ b/MdePkg/Include/Protocol/SimpleTextInEx.h @@ -3,11 +3,11 @@ =20 This protocol defines an extension to the EFI_SIMPLE_TEXT_INPUT_PROTOCOL which exposes much more state and modifier information from the input de= vice, also allows one to register a notification for a particular keystroke. =20 - Copyright (c) 2006 - 2012, Intel Corporation. All rights reserved.
+ Copyright (c) 2006 - 2017, Intel Corporation. All rights reserved.
This program and the accompanying materials are licensed and made available under the terms and conditions of the BS= D License which accompanies this distribution. The full text of the license may b= e found at http://opensource.org/licenses/bsd-license.php =20 @@ -249,22 +249,23 @@ EFI_STATUS =20 @param This A pointer to the EFI_SIMPLE_TEXT_INPUT_E= X_PROTOCOL instance. =20 @param KeyData A pointer to a buffer that is filled in = with the keystroke information for the key th= at was - pressed. + pressed. If KeyData.Key, KeyData.KeyStat= e.KeyToggleState + and KeyData.KeyState.KeyShiftState are 0= , then any incomplete + keystroke will trigger a notification of= the KeyNotificationFunction. =20 - @param KeyNotificationFunction Points to the function to be - called when the key sequence - is typed specified by KeyData. + @param KeyNotificationFunction Points to the function to be called when= the key sequence + is typed specified by KeyData. This noti= fication function + should be called at <=3DTPL_CALLBACK. =20 =20 @param NotifyHandle Points to the unique handle assigned to the registered notification. =20 - @retval EFI_SUCCESS The device state was set - appropriately. + @retval EFI_SUCCESS Key notify was registered successfully. =20 @retval EFI_OUT_OF_RESOURCES Unable to allocate necessary data structures. =20 **/ @@ -284,11 +285,11 @@ EFI_STATUS @param This A pointer to the EFI_SIMPLE_TEXT_INPUT_EX_PROT= OCOL instance. =20 @param NotificationHandle The handle of the notification function being unregistered. =20 - @retval EFI_SUCCESS The device state was set appropriately. + @retval EFI_SUCCESS Key notify was unregistered successfully. =20 @retval EFI_INVALID_PARAMETER The NotificationHandle is invalid. =20 **/ --=20 1.9.5.msysgit.1 _______________________________________________ edk2-devel mailing list edk2-devel@lists.01.org https://lists.01.org/mailman/listinfo/edk2-devel From nobody Thu May 2 05:51:28 2024 Delivered-To: importer@patchew.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; Authentication-Results: mx.zoho.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 1497847624503961.2026549699001; Sun, 18 Jun 2017 21:47:04 -0700 (PDT) Received: from [127.0.0.1] (localhost [IPv6:::1]) by ml01.01.org (Postfix) with ESMTP id EED2521C8F631; Sun, 18 Jun 2017 21:45:39 -0700 (PDT) Received: from mga09.intel.com (mga09.intel.com [134.134.136.24]) (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 5D0D221962337 for ; Sun, 18 Jun 2017 21:45:39 -0700 (PDT) Received: from orsmga002.jf.intel.com ([10.7.209.21]) by orsmga102.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 18 Jun 2017 21:47:00 -0700 Received: from shwdeopenpsi114.ccr.corp.intel.com ([10.239.157.135]) by orsmga002.jf.intel.com with ESMTP; 18 Jun 2017 21:46:59 -0700 X-Original-To: edk2-devel@lists.01.org X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.39,359,1493708400"; d="scan'208";a="100987139" From: Dandan Bi To: edk2-devel@lists.01.org Date: Mon, 19 Jun 2017 12:46:20 +0800 Message-Id: <1497847586-18144-3-git-send-email-dandan.bi@intel.com> X-Mailer: git-send-email 1.9.5.msysgit.1 In-Reply-To: <1497847586-18144-1-git-send-email-dandan.bi@intel.com> References: <1497847586-18144-1-git-send-email-dandan.bi@intel.com> Subject: [edk2] [PATCH v2 2/8] IntelFrameworkModulePkg: Update comments in SimpleTextInEx 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: Ruiyu Ni , Jeff Fan , Star Zeng 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" Update comments in SimpleTextInEx according to UEFI 2.7. Cc: Star Zeng Cc: Ruiyu Ni Cc: Jeff Fan Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Dandan Bi Reviewed-by: Star Zeng to this patch series. --- .../Bus/Isa/Ps2KeyboardDxe/Ps2KbdTextIn.c | 10 +++++++--- .../Bus/Isa/Ps2KeyboardDxe/Ps2Keyboard.h | 10 +++++++--- .../Csm/BiosThunk/KeyboardDxe/BiosKeyboard.c | 15 +++++++++---= --- .../Csm/BiosThunk/KeyboardDxe/BiosKeyboard.h | 16 ++++++++++--= ---- 4 files changed, 33 insertions(+), 18 deletions(-) diff --git a/IntelFrameworkModulePkg/Bus/Isa/Ps2KeyboardDxe/Ps2KbdTextIn.c = b/IntelFrameworkModulePkg/Bus/Isa/Ps2KeyboardDxe/Ps2KbdTextIn.c index 5825a04..7677955 100644 --- a/IntelFrameworkModulePkg/Bus/Isa/Ps2KeyboardDxe/Ps2KbdTextIn.c +++ b/IntelFrameworkModulePkg/Bus/Isa/Ps2KeyboardDxe/Ps2KbdTextIn.c @@ -1,10 +1,10 @@ /** @file Routines implements SIMPLE_TEXT_IN protocol's interfaces based on 8042 i= nterfaces provided by Ps2KbdCtrller.c. =20 -Copyright (c) 2006 - 2016, Intel Corporation. All rights reserved.
+Copyright (c) 2006 - 2017, Intel Corporation. All rights reserved.
This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD = License which accompanies this distribution. The full text of the license may be = found at http://opensource.org/licenses/bsd-license.php =20 @@ -531,13 +531,17 @@ Exit: /** Register a notification function for a particular keystroke for the in= put device. =20 @param This Protocol instance pointer. @param KeyData A pointer to a buffer that is filled= in with the keystroke - information data for the key that wa= s pressed. + information data for the key that wa= s pressed. If KeyData.Key, + KeyData.KeyState.KeyToggleState and = KeyData.KeyState.KeyShiftState + are 0, then any incomplete keystroke= will trigger a notification of + the KeyNotificationFunction. @param KeyNotificationFunction Points to the function to be called = when the key - sequence is typed specified by KeyDa= ta. + sequence is typed specified by KeyDa= ta. This notification function + should be called at <=3DTPL_CALLBACK. @param NotifyHandle Points to the unique handle assigned= to the registered notification. =20 @retval EFI_SUCCESS The notification function was regist= ered successfully. @retval EFI_OUT_OF_RESOURCES Unable to allocate resources for nec= esssary data structures. @retval EFI_INVALID_PARAMETER KeyData or NotifyHandle or KeyNotifi= cationFunction is NULL. diff --git a/IntelFrameworkModulePkg/Bus/Isa/Ps2KeyboardDxe/Ps2Keyboard.h b= /IntelFrameworkModulePkg/Bus/Isa/Ps2KeyboardDxe/Ps2Keyboard.h index 82aa5a6..76fb498 100644 --- a/IntelFrameworkModulePkg/Bus/Isa/Ps2KeyboardDxe/Ps2Keyboard.h +++ b/IntelFrameworkModulePkg/Bus/Isa/Ps2KeyboardDxe/Ps2Keyboard.h @@ -1,9 +1,9 @@ /** @file PS/2 keyboard driver header file =20 -Copyright (c) 2006 - 2016, Intel Corporation. All rights reserved.
+Copyright (c) 2006 - 2017, Intel Corporation. All rights reserved.
This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD = License which accompanies this distribution. The full text of the license may be = found at http://opensource.org/licenses/bsd-license.php =20 @@ -492,13 +492,17 @@ KeyboardSetState ( /** Register a notification function for a particular keystroke for the in= put device. =20 @param This - Protocol instance pointer. @param KeyData - A pointer to a buffer that is filled = in with the keystroke - information data for the key that was presse= d. + information data for the key that was= pressed. If KeyData.Key, + KeyData.KeyState.KeyToggleState and K= eyData.KeyState.KeyShiftState + are 0, then any incomplete keystroke = will trigger a notification of + the KeyNotificationFunction. @param KeyNotificationFunction - Points to the function to be called w= hen the key - sequence is typed specified by KeyData. + sequence is typed specified by KeyDat= a. This notification function + should be called at <=3DTPL_CALLBACK. @param NotifyHandle - Points to the unique handle assigned = to the registered notification. =20 @retval EFI_SUCCESS - The notification function was regist= ered successfully. @retval EFI_OUT_OF_RESOURCES - Unable to allocate resources for nec= esssary data structures. @retval EFI_INVALID_PARAMETER - KeyData or NotifyHandle is NULL. diff --git a/IntelFrameworkModulePkg/Csm/BiosThunk/KeyboardDxe/BiosKeyboard= .c b/IntelFrameworkModulePkg/Csm/BiosThunk/KeyboardDxe/BiosKeyboard.c index 742d009..7308523 100644 --- a/IntelFrameworkModulePkg/Csm/BiosThunk/KeyboardDxe/BiosKeyboard.c +++ b/IntelFrameworkModulePkg/Csm/BiosThunk/KeyboardDxe/BiosKeyboard.c @@ -2311,21 +2311,24 @@ Exit: /** Register a notification function for a particular keystroke for the inpu= t device. =20 @param This Protocol instance pointer. @param KeyData A pointer to a buffer that is filled in = with the keystroke=20 - information data for the key that was pr= essed. + information data for the key that was pr= essed. If KeyData.Key, + KeyData.KeyState.KeyToggleState and KeyD= ata.KeyState.KeyShiftState + are 0, then any incomplete keystroke wil= l trigger a notification of + the KeyNotificationFunction. @param KeyNotificationFunction Points to the function to be called when= the key=20 - sequence is typed specified by KeyData. = =20 - @param NotifyHandle Points to the unique handle assigned to = the registered notification. =20 + sequence is typed specified by KeyData. = This notification function + should be called at <=3DTPL_CALLBACK. + @param NotifyHandle Points to the unique handle assigned to = the registered notification. =20 - =20 @retval EFI_SUCCESS The notification function was registered= successfully. @retval EFI_OUT_OF_RESOURCES Unable to allocate resources for necesss= ary data structures. @retval EFI_INVALID_PARAMETER KeyData or NotifyHandle is NULL. - =20 -**/ =20 + +**/ EFI_STATUS EFIAPI BiosKeyboardRegisterKeyNotify ( IN EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL *This, IN EFI_KEY_DATA *KeyData, diff --git a/IntelFrameworkModulePkg/Csm/BiosThunk/KeyboardDxe/BiosKeyboard= .h b/IntelFrameworkModulePkg/Csm/BiosThunk/KeyboardDxe/BiosKeyboard.h index f38411a..0bf28ea 100644 --- a/IntelFrameworkModulePkg/Csm/BiosThunk/KeyboardDxe/BiosKeyboard.h +++ b/IntelFrameworkModulePkg/Csm/BiosThunk/KeyboardDxe/BiosKeyboard.h @@ -1,8 +1,8 @@ /** @file =20 -Copyright (c) 2006 - 2016, Intel Corporation. All rights reserved.
+Copyright (c) 2006 - 2017, Intel Corporation. All rights reserved.
=20 This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD License which accompanies this distribution. The full text of the license may be found at @@ -633,21 +633,25 @@ BiosKeyboardSetState ( /** Register a notification function for a particular keystroke for the inpu= t device. =20 @param This Protocol instance pointer. @param KeyData A pointer to a buffer that is filled in = with the keystroke=20 - information data for the key that was pr= essed. + information data for the key that was pr= essed. If KeyData.Key, + KeyData.KeyState.KeyToggleState and KeyD= ata.KeyState.KeyShiftState + are 0, then any incomplete keystroke wil= l trigger a notification of + the KeyNotificationFunction. @param KeyNotificationFunction Points to the function to be called when= the key=20 - sequence is typed specified by KeyData. = =20 - @param NotifyHandle Points to the unique handle assigned to = the registered notification. =20 + sequence is typed specified by KeyData. = This notification function + should be called at <=3DTPL_CALLBACK. + @param NotifyHandle Points to the unique handle assigned to = the registered notification. =20 =20 @retval EFI_SUCCESS The notification function was registered= successfully. @retval EFI_OUT_OF_RESOURCES Unable to allocate resources for necesss= ary data structures. @retval EFI_INVALID_PARAMETER KeyData or NotifyHandle is NULL. - =20 -**/ =20 + +**/ EFI_STATUS EFIAPI BiosKeyboardRegisterKeyNotify ( IN EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL *This, IN EFI_KEY_DATA *KeyData, --=20 1.9.5.msysgit.1 _______________________________________________ edk2-devel mailing list edk2-devel@lists.01.org https://lists.01.org/mailman/listinfo/edk2-devel From nobody Thu May 2 05:51:28 2024 Delivered-To: importer@patchew.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; Authentication-Results: mx.zoho.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 1497847632147478.72544556329876; Sun, 18 Jun 2017 21:47:12 -0700 (PDT) Received: from [127.0.0.1] (localhost [IPv6:::1]) by ml01.01.org (Postfix) with ESMTP id 4375821C8F635; Sun, 18 Jun 2017 21:45:49 -0700 (PDT) Received: from mga04.intel.com (mga04.intel.com [192.55.52.120]) (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 6B3B721C8F618 for ; Sun, 18 Jun 2017 21:45:47 -0700 (PDT) Received: from orsmga002.jf.intel.com ([10.7.209.21]) by fmsmga104.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 18 Jun 2017 21:47:08 -0700 Received: from shwdeopenpsi114.ccr.corp.intel.com ([10.239.157.135]) by orsmga002.jf.intel.com with ESMTP; 18 Jun 2017 21:47:07 -0700 X-Original-To: edk2-devel@lists.01.org X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.39,359,1493708400"; d="scan'208";a="100987265" From: Dandan Bi To: edk2-devel@lists.01.org Date: Mon, 19 Jun 2017 12:46:21 +0800 Message-Id: <1497847586-18144-4-git-send-email-dandan.bi@intel.com> X-Mailer: git-send-email 1.9.5.msysgit.1 In-Reply-To: <1497847586-18144-1-git-send-email-dandan.bi@intel.com> References: <1497847586-18144-1-git-send-email-dandan.bi@intel.com> Subject: [edk2] [PATCH v2 3/8] MdeModulePkg: Update comments in SimpleTextInEx according to UEFI 2.7 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: Ruiyu Ni , Star Zeng 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" v2: Add some missing changes Ps2KeyboardDxe. Cc: Star Zeng Cc: Ruiyu Ni Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Dandan Bi Reviewed-by: Star Zeng to this patch series. --- MdeModulePkg/Bus/Isa/Ps2KeyboardDxe/Ps2KbdTextIn.c | 9 ++++++--- MdeModulePkg/Bus/Isa/Ps2KeyboardDxe/Ps2Keyboard.h | 9 ++++++--- MdeModulePkg/Bus/Usb/UsbKbDxe/EfiKey.c | 12 ++++++++-= --- MdeModulePkg/Bus/Usb/UsbKbDxe/EfiKey.h | 12 ++++++++-= --- MdeModulePkg/Universal/Console/ConSplitterDxe/ConSplitter.c | 11 +++++++--= -- MdeModulePkg/Universal/Console/ConSplitterDxe/ConSplitter.h | 11 +++++++--= -- MdeModulePkg/Universal/Console/TerminalDxe/Terminal.h | 7 +++++-- MdeModulePkg/Universal/Console/TerminalDxe/TerminalConIn.c | 11 +++++++--= -- 8 files changed, 54 insertions(+), 28 deletions(-) diff --git a/MdeModulePkg/Bus/Isa/Ps2KeyboardDxe/Ps2KbdTextIn.c b/MdeModule= Pkg/Bus/Isa/Ps2KeyboardDxe/Ps2KbdTextIn.c index bc58fe2..04e3365 100644 --- a/MdeModulePkg/Bus/Isa/Ps2KeyboardDxe/Ps2KbdTextIn.c +++ b/MdeModulePkg/Bus/Isa/Ps2KeyboardDxe/Ps2KbdTextIn.c @@ -1,10 +1,10 @@ /** @file Routines implements SIMPLE_TEXT_IN protocol's interfaces based on 8042 i= nterfaces provided by Ps2KbdCtrller.c. =20 -Copyright (c) 2006 - 2016, Intel Corporation. All rights reserved.
+Copyright (c) 2006 - 2017, Intel Corporation. All rights reserved.
This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD = License which accompanies this distribution. The full text of the license may be = found at http://opensource.org/licenses/bsd-license.php =20 @@ -531,13 +531,16 @@ Exit: /** Register a notification function for a particular keystroke for the in= put device. =20 @param This Protocol instance pointer. @param KeyData A pointer to a buffer that is filled= in with the keystroke - information data for the key that wa= s pressed. + information data for the key that wa= s pressed. If KeyData.Key, + KeyData.KeyState.KeyToggleState and = KeyData.KeyState.KeyShiftState are 0, + then any incomplete keystroke will t= rigger a notification of the KeyNotificationFunction. @param KeyNotificationFunction Points to the function to be called = when the key - sequence is typed specified by KeyDa= ta. + sequence is typed specified by KeyDa= ta. This notification function + should be called at <=3DTPL_CALLBACK. @param NotifyHandle Points to the unique handle assigned= to the registered notification. =20 @retval EFI_SUCCESS The notification function was regist= ered successfully. @retval EFI_OUT_OF_RESOURCES Unable to allocate resources for nec= esssary data structures. @retval EFI_INVALID_PARAMETER KeyData or NotifyHandle or KeyNotifi= cationFunction is NULL. diff --git a/MdeModulePkg/Bus/Isa/Ps2KeyboardDxe/Ps2Keyboard.h b/MdeModuleP= kg/Bus/Isa/Ps2KeyboardDxe/Ps2Keyboard.h index e41c198..d772a97 100644 --- a/MdeModulePkg/Bus/Isa/Ps2KeyboardDxe/Ps2Keyboard.h +++ b/MdeModulePkg/Bus/Isa/Ps2KeyboardDxe/Ps2Keyboard.h @@ -1,9 +1,9 @@ /** @file PS/2 keyboard driver header file =20 -Copyright (c) 2006 - 2016, Intel Corporation. All rights reserved.
+Copyright (c) 2006 - 2017, Intel Corporation. All rights reserved.
This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD = License which accompanies this distribution. The full text of the license may be = found at http://opensource.org/licenses/bsd-license.php =20 @@ -493,13 +493,16 @@ KeyboardSetState ( /** Register a notification function for a particular keystroke for the in= put device. =20 @param This - Protocol instance pointer. @param KeyData - A pointer to a buffer that is filled = in with the keystroke - information data for the key that was presse= d. + information data for the key that was= pressed. If KeyData.Key, + KeyData.KeyState.KeyToggleState and K= eyData.KeyState.KeyShiftState are 0, + then any incomplete keystroke will tr= igger a notification of the KeyNotificationFunction. @param KeyNotificationFunction - Points to the function to be called w= hen the key - sequence is typed specified by KeyData. + sequence is typed specified by KeyDat= a. This notification function + should be called at <=3DTPL_CALLBACK. @param NotifyHandle - Points to the unique handle assigned = to the registered notification. =20 @retval EFI_SUCCESS - The notification function was regist= ered successfully. @retval EFI_OUT_OF_RESOURCES - Unable to allocate resources for nec= esssary data structures. @retval EFI_INVALID_PARAMETER - KeyData or NotifyHandle is NULL. diff --git a/MdeModulePkg/Bus/Usb/UsbKbDxe/EfiKey.c b/MdeModulePkg/Bus/Usb/= UsbKbDxe/EfiKey.c index cdd1684..fb2bf3f 100644 --- a/MdeModulePkg/Bus/Usb/UsbKbDxe/EfiKey.c +++ b/MdeModulePkg/Bus/Usb/UsbKbDxe/EfiKey.c @@ -1,10 +1,10 @@ /** @file USB Keyboard Driver that manages USB keyboard and produces Simple Text I= nput Protocol and Simple Text Input Ex Protocol. =20 -Copyright (c) 2004 - 2016, Intel Corporation. All rights reserved.
+Copyright (c) 2004 - 2017, Intel Corporation. All rights reserved.
This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD = License which accompanies this distribution. The full text of the license may be = found at http://opensource.org/licenses/bsd-license.php =20 @@ -1053,14 +1053,18 @@ USBKeyboardSetState ( =20 /** Register a notification function for a particular keystroke for the inpu= t device. =20 @param This Protocol instance pointer. - @param KeyData A pointer to a buffer that is filled= in with the keystroke - information data for the key that wa= s pressed. + @param KeyData A pointer to a buffer that is filled= in with + the keystroke information for the ke= y that was + pressed. If KeyData.Key, KeyData.Key= State.KeyToggleState + and KeyData.KeyState.KeyShiftState a= re 0, then any incomplete + keystroke will trigger a notificatio= n of the KeyNotificationFunction. @param KeyNotificationFunction Points to the function to be called = when the key - sequence is typed specified by KeyDa= ta. + sequence is typed specified by KeyDa= ta. This notification function + should be called at <=3DTPL_CALLBACK. @param NotifyHandle Points to the unique handle assigned= to the registered notification. =20 @retval EFI_SUCCESS The notification function was regist= ered successfully. @retval EFI_OUT_OF_RESOURCES Unable to allocate resources for nec= essary data structures. @retval EFI_INVALID_PARAMETER KeyData or NotifyHandle or KeyNotifi= cationFunction is NULL. diff --git a/MdeModulePkg/Bus/Usb/UsbKbDxe/EfiKey.h b/MdeModulePkg/Bus/Usb/= UsbKbDxe/EfiKey.h index 089f113..6049678 100644 --- a/MdeModulePkg/Bus/Usb/UsbKbDxe/EfiKey.h +++ b/MdeModulePkg/Bus/Usb/UsbKbDxe/EfiKey.h @@ -1,9 +1,9 @@ /** @file Header file for USB Keyboard Driver's Data Structures. =20 -Copyright (c) 2004 - 2016, Intel Corporation. All rights reserved.
+Copyright (c) 2004 - 2017, Intel Corporation. All rights reserved.
This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD = License which accompanies this distribution. The full text of the license may be = found at http://opensource.org/licenses/bsd-license.php =20 @@ -500,14 +500,18 @@ USBKeyboardSetState ( =20 /** Register a notification function for a particular keystroke for the inpu= t device. =20 @param This Protocol instance pointer. - @param KeyData A pointer to a buffer that is filled= in with the keystroke - information data for the key that wa= s pressed. + @param KeyData A pointer to a buffer that is filled= in with + the keystroke information for the ke= y that was + pressed. If KeyData.Key, KeyData.Key= State.KeyToggleState + and KeyData.KeyState.KeyShiftState a= re 0, then any incomplete + keystroke will trigger a notificatio= n of the KeyNotificationFunction. @param KeyNotificationFunction Points to the function to be called = when the key - sequence is typed specified by KeyDa= ta. + sequence is typed specified by KeyDa= ta. This notification function + should be called at <=3DTPL_CALLBACK. @param NotifyHandle Points to the unique handle assigned= to the registered notification. =20 @retval EFI_SUCCESS The notification function was regist= ered successfully. @retval EFI_OUT_OF_RESOURCES Unable to allocate resources for nec= esssary data structures. @retval EFI_INVALID_PARAMETER KeyData or NotifyHandle or KeyNotifi= cationFunction is NULL. diff --git a/MdeModulePkg/Universal/Console/ConSplitterDxe/ConSplitter.c b/= MdeModulePkg/Universal/Console/ConSplitterDxe/ConSplitter.c index b230f5e..e70ff61 100644 --- a/MdeModulePkg/Universal/Console/ConSplitterDxe/ConSplitter.c +++ b/MdeModulePkg/Universal/Console/ConSplitterDxe/ConSplitter.c @@ -3840,15 +3840,18 @@ ConSplitterTextInSetState ( =20 /** Register a notification function for a particular keystroke for the inpu= t device. =20 @param This Protocol instance pointer. - @param KeyData A pointer to a buffer that is filled in= with the - keystroke information data for the key = that was - pressed. + @param KeyData A pointer to a buffer that is filled in= with + the keystroke information for the key t= hat was + pressed. If KeyData.Key, KeyData.KeySta= te.KeyToggleState + and KeyData.KeyState.KeyShiftState are = 0, then any incomplete + keystroke will trigger a notification o= f the KeyNotificationFunction. @param KeyNotificationFunction Points to the function to be called whe= n the key - sequence is typed specified by KeyData. + sequence is typed specified by KeyData.= This notification function + should be called at <=3DTPL_CALLBACK. @param NotifyHandle Points to the unique handle assigned to= the registered notification. =20 @retval EFI_SUCCESS The notification function was registered successfully. diff --git a/MdeModulePkg/Universal/Console/ConSplitterDxe/ConSplitter.h b/= MdeModulePkg/Universal/Console/ConSplitterDxe/ConSplitter.h index eeea061..9469860 100644 --- a/MdeModulePkg/Universal/Console/ConSplitterDxe/ConSplitter.h +++ b/MdeModulePkg/Universal/Console/ConSplitterDxe/ConSplitter.h @@ -1394,15 +1394,18 @@ ConSplitterTextInSetState ( =20 /** Register a notification function for a particular keystroke for the inpu= t device. =20 @param This Protocol instance pointer. - @param KeyData A pointer to a buffer that is filled in= with the - keystroke information data for the key = that was - pressed. + @param KeyData A pointer to a buffer that is filled in= with + the keystroke information for the key t= hat was + pressed. If KeyData.Key, KeyData.KeySta= te.KeyToggleState + and KeyData.KeyState.KeyShiftState are = 0, then any incomplete + keystroke will trigger a notification o= f the KeyNotificationFunction. @param KeyNotificationFunction Points to the function to be called whe= n the key - sequence is typed specified by KeyData. + sequence is typed specified by KeyData.= This notification function + should be called at <=3DTPL_CALLBACK. @param NotifyHandle Points to the unique handle assigned to= the registered notification. =20 @retval EFI_SUCCESS The notification function was registered successfully. diff --git a/MdeModulePkg/Universal/Console/TerminalDxe/Terminal.h b/MdeMod= ulePkg/Universal/Console/TerminalDxe/Terminal.h index c15d17c..7dded00 100644 --- a/MdeModulePkg/Universal/Console/TerminalDxe/Terminal.h +++ b/MdeModulePkg/Universal/Console/TerminalDxe/Terminal.h @@ -341,13 +341,16 @@ TerminalConInSetState ( Register a notification function for a particular keystroke for the inpu= t device. =20 @param This Protocol instance pointer. @param KeyData A pointer to a buffer that is filled in= with the keystroke information data for the key = that was - pressed. + pressed. If KeyData.Key, KeyData.KeySta= te.KeyToggleState + and KeyData.KeyState.KeyShiftState are = 0, then any incomplete + keystroke will trigger a notification o= f the KeyNotificationFunction. @param KeyNotificationFunction Points to the function to be called whe= n the key - sequence is typed specified by KeyData. + sequence is typed specified by KeyData.= This notification function + should be called at <=3DTPL_CALLBACK. @param NotifyHandle Points to the unique handle assigned to= the registered notification. =20 @retval EFI_SUCCESS The notification function was registered successfully. diff --git a/MdeModulePkg/Universal/Console/TerminalDxe/TerminalConIn.c b/M= deModulePkg/Universal/Console/TerminalDxe/TerminalConIn.c index 1392f16..3c1102d 100644 --- a/MdeModulePkg/Universal/Console/TerminalDxe/TerminalConIn.c +++ b/MdeModulePkg/Universal/Console/TerminalDxe/TerminalConIn.c @@ -308,15 +308,18 @@ TerminalConInSetState ( =20 /** Register a notification function for a particular keystroke for the inpu= t device. =20 @param This Protocol instance pointer. - @param KeyData A pointer to a buffer that is filled in= with the - keystroke information data for the key = that was - pressed. + @param KeyData A pointer to a buffer that is filled in= with + the keystroke information for the key t= hat was + pressed. If KeyData.Key, KeyData.KeySta= te.KeyToggleState + and KeyData.KeyState.KeyShiftState are = 0, then any incomplete + keystroke will trigger a notification o= f the KeyNotificationFunction. @param KeyNotificationFunction Points to the function to be called whe= n the key - sequence is typed specified by KeyData. + sequence is typed specified by KeyData.= This notification function + should be called at <=3DTPL_CALLBACK. @param NotifyHandle Points to the unique handle assigned to= the registered notification. =20 @retval EFI_SUCCESS The notification function was registered successfully. --=20 1.9.5.msysgit.1 _______________________________________________ edk2-devel mailing list edk2-devel@lists.01.org https://lists.01.org/mailman/listinfo/edk2-devel From nobody Thu May 2 05:51:28 2024 Delivered-To: importer@patchew.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; Authentication-Results: mx.zoho.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 1497847634322246.00682758839423; Sun, 18 Jun 2017 21:47:14 -0700 (PDT) Received: from [127.0.0.1] (localhost [IPv6:::1]) by ml01.01.org (Postfix) with ESMTP id 7ABF821C8F638; Sun, 18 Jun 2017 21:45:51 -0700 (PDT) Received: from mga04.intel.com (mga04.intel.com [192.55.52.120]) (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 E22C621C8F62D for ; Sun, 18 Jun 2017 21:45:48 -0700 (PDT) Received: from orsmga002.jf.intel.com ([10.7.209.21]) by fmsmga104.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 18 Jun 2017 21:47:09 -0700 Received: from shwdeopenpsi114.ccr.corp.intel.com ([10.239.157.135]) by orsmga002.jf.intel.com with ESMTP; 18 Jun 2017 21:47:09 -0700 X-Original-To: edk2-devel@lists.01.org X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.39,359,1493708400"; d="scan'208";a="100987274" From: Dandan Bi To: edk2-devel@lists.01.org Date: Mon, 19 Jun 2017 12:46:22 +0800 Message-Id: <1497847586-18144-5-git-send-email-dandan.bi@intel.com> X-Mailer: git-send-email 1.9.5.msysgit.1 In-Reply-To: <1497847586-18144-1-git-send-email-dandan.bi@intel.com> References: <1497847586-18144-1-git-send-email-dandan.bi@intel.com> Subject: [edk2] [PATCH v2 4/8] MdePkg/HiiImageDecoder.h: Remove the unnecessary comments 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: Ruiyu Ni , Liming Gao 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: Liming Gao Cc: Ruiyu Ni Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Dandan Bi Reviewed-by: Star Zeng to this patch series. --- MdePkg/Include/Protocol/HiiImageDecoder.h | 9 --------- 1 file changed, 9 deletions(-) diff --git a/MdePkg/Include/Protocol/HiiImageDecoder.h b/MdePkg/Include/Pro= tocol/HiiImageDecoder.h index 48a1a97..34eb5e1 100644 --- a/MdePkg/Include/Protocol/HiiImageDecoder.h +++ b/MdePkg/Include/Protocol/HiiImageDecoder.h @@ -16,19 +16,10 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITH= ER EXPRESS OR IMPLIED. #ifndef __HII_IMAGE_DECODER_H__ #define __HII_IMAGE_DECODER_H__ =20 #include =20 - -// -// In UEFI 2.6 spec,this guid value is duplicate with -// EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_GUID. Now update this guid value to -// avoid the duplicate guid issue. So its value is not consistent with -// UEFI spec definition now. We have proposed to update UEFI spec to -// use this new guid. After new spec released, we will remove this -// comments. -// #define EFI_HII_IMAGE_DECODER_PROTOCOL_GUID \ {0x9e66f251, 0x727c, 0x418c, { 0xbf, 0xd6, 0xc2, 0xb4, 0x25, 0x28, 0x18,= 0xea }} =20 =20 #define EFI_HII_IMAGE_DECODER_NAME_JPEG_GUID \ --=20 1.9.5.msysgit.1 _______________________________________________ edk2-devel mailing list edk2-devel@lists.01.org https://lists.01.org/mailman/listinfo/edk2-devel From nobody Thu May 2 05:51:28 2024 Delivered-To: importer@patchew.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; Authentication-Results: mx.zoho.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 1497847636569663.4612201249138; Sun, 18 Jun 2017 21:47:16 -0700 (PDT) Received: from [127.0.0.1] (localhost [IPv6:::1]) by ml01.01.org (Postfix) with ESMTP id B12BC21BB2530; Sun, 18 Jun 2017 21:45:51 -0700 (PDT) Received: from mga04.intel.com (mga04.intel.com [192.55.52.120]) (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 A600621C8F618 for ; Sun, 18 Jun 2017 21:45:50 -0700 (PDT) Received: from orsmga002.jf.intel.com ([10.7.209.21]) by fmsmga104.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 18 Jun 2017 21:47:11 -0700 Received: from shwdeopenpsi114.ccr.corp.intel.com ([10.239.157.135]) by orsmga002.jf.intel.com with ESMTP; 18 Jun 2017 21:47:10 -0700 X-Original-To: edk2-devel@lists.01.org X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.39,359,1493708400"; d="scan'208";a="100987280" From: Dandan Bi To: edk2-devel@lists.01.org Date: Mon, 19 Jun 2017 12:46:23 +0800 Message-Id: <1497847586-18144-6-git-send-email-dandan.bi@intel.com> X-Mailer: git-send-email 1.9.5.msysgit.1 In-Reply-To: <1497847586-18144-1-git-send-email-dandan.bi@intel.com> References: <1497847586-18144-1-git-send-email-dandan.bi@intel.com> Subject: [edk2] [PATCH v2 5/8] MdePkg: Update comments in EFI_MEMORY_DESCRIPTOR according to UEFI2.7 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: Star Zeng , Liming Gao 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: Liming Gao Cc: Star Zeng Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Dandan Bi Reviewed-by: Star Zeng to this patch series. --- MdePkg/Include/Uefi/UefiSpec.h | 21 ++++++++++++++------- 1 file changed, 14 insertions(+), 7 deletions(-) diff --git a/MdePkg/Include/Uefi/UefiSpec.h b/MdePkg/Include/Uefi/UefiSpec.h index 57cb4e8..4c541a6 100644 --- a/MdePkg/Include/Uefi/UefiSpec.h +++ b/MdePkg/Include/Uefi/UefiSpec.h @@ -3,11 +3,11 @@ =20 This include file must contain things defined in the UEFI 2.6 specificat= ion. If a code construct is defined in the UEFI 2.6 specification it must be = included by this include file. =20 -Copyright (c) 2006 - 2016, Intel Corporation. All rights reserved.
+Copyright (c) 2006 - 2017, Intel Corporation. All rights reserved.
This program and the accompanying materials are licensed and made availabl= e under=20 the terms and conditions of the BSD License that accompanies this distribu= tion. =20 The full text of the license may be found at http://opensource.org/licenses/bsd-license.php. = =20 =20 @@ -101,25 +101,32 @@ typedef enum { /// /// Definition of an EFI memory descriptor. /// typedef struct { /// - /// Type of the memory region. See EFI_MEMORY_TYPE. + /// Type of the memory region. + /// Type EFI_MEMORY_TYPE is defined in the + /// AllocatePages() function description. /// UINT32 Type; /// - /// Physical address of the first byte of the memory region. Must align= ed=20 - /// on a 4 KB boundary. + /// Physical address of the first byte in the memory region. PhysicalSta= rt must be + /// aligned on a 4 KiB boundary, and must not be above 0xfffffffffffff00= 0. Type + /// EFI_PHYSICAL_ADDRESS is defined in the AllocatePages() function desc= ription /// EFI_PHYSICAL_ADDRESS PhysicalStart; /// - /// Virtual address of the first byte of the memory region. Must aligne= d=20 - /// on a 4 KB boundary. + /// Virtual address of the first byte in the memory region. + /// VirtualStart must be aligned on a 4 KiB boundary, + /// and must not be above 0xfffffffffffff000. /// EFI_VIRTUAL_ADDRESS VirtualStart; /// - /// Number of 4KB pages in the memory region. + /// NumberOfPagesNumber of 4 KiB pages in the memory region. + /// NumberOfPages must not be 0, and must not be any value + /// that would represent a memory page with a start address, + /// either physical or virtual, above 0xfffffffffffff000. /// UINT64 NumberOfPages; /// /// Attributes of the memory region that describe the bit mask of capabi= lities /// for that memory region, and not necessarily the current settings for= that=20 --=20 1.9.5.msysgit.1 _______________________________________________ edk2-devel mailing list edk2-devel@lists.01.org https://lists.01.org/mailman/listinfo/edk2-devel From nobody Thu May 2 05:51:28 2024 Delivered-To: importer@patchew.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; Authentication-Results: mx.zoho.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 1497847638926623.4542631862456; Sun, 18 Jun 2017 21:47:18 -0700 (PDT) Received: from [127.0.0.1] (localhost [IPv6:::1]) by ml01.01.org (Postfix) with ESMTP id EBAF621C8F62D; Sun, 18 Jun 2017 21:45:53 -0700 (PDT) Received: from mga04.intel.com (mga04.intel.com [192.55.52.120]) (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 948B821C8F637 for ; Sun, 18 Jun 2017 21:45:52 -0700 (PDT) Received: from orsmga002.jf.intel.com ([10.7.209.21]) by fmsmga104.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 18 Jun 2017 21:47:13 -0700 Received: from shwdeopenpsi114.ccr.corp.intel.com ([10.239.157.135]) by orsmga002.jf.intel.com with ESMTP; 18 Jun 2017 21:47:12 -0700 X-Original-To: edk2-devel@lists.01.org X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.39,359,1493708400"; d="scan'208";a="100987292" From: Dandan Bi To: edk2-devel@lists.01.org Date: Mon, 19 Jun 2017 12:46:24 +0800 Message-Id: <1497847586-18144-7-git-send-email-dandan.bi@intel.com> X-Mailer: git-send-email 1.9.5.msysgit.1 In-Reply-To: <1497847586-18144-1-git-send-email-dandan.bi@intel.com> References: <1497847586-18144-1-git-send-email-dandan.bi@intel.com> Subject: [edk2] [PATCH v2 6/8] MdePkg: update comments in ResetSystem() according to UEFI2.7 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: Ruiyu Ni , Liming Gao 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: Liming Gao Cc: Ruiyu Ni Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Dandan Bi Reviewed-by: Star Zeng to this patch series. --- MdePkg/Include/Library/UefiRuntimeLib.h | 7 +++---- MdePkg/Include/Uefi/UefiSpec.h | 3 +++ 2 files changed, 6 insertions(+), 4 deletions(-) diff --git a/MdePkg/Include/Library/UefiRuntimeLib.h b/MdePkg/Include/Libra= ry/UefiRuntimeLib.h index 99ca824..0bca416 100644 --- a/MdePkg/Include/Library/UefiRuntimeLib.h +++ b/MdePkg/Include/Library/UefiRuntimeLib.h @@ -1,10 +1,10 @@ /** @file Provides library functions for each of the UEFI Runtime Services. Only available to DXE and UEFI module types. =20 -Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.
+Copyright (c) 2006 - 2017, Intel Corporation. All rights reserved.
This program and the accompanying materials are licensed and made availabl= e under=20 the terms and conditions of the BSD License that accompanies this distribu= tion. =20 The full text of the license may be found at http://opensource.org/licenses/bsd-license.php. =20 @@ -327,13 +327,12 @@ EfiGetNextHighMonotonicCount ( @param DataSizeThe size, in bytes, of ResetData. @param ResetData For a ResetType of EfiResetCold, EfiResetWarm, or Ef= iResetShutdown the data buffer starts with a Null-terminated Unicode string, optionally followed = by additional binary data. The string is a description that the caller may use to further indic= ate the reason for the system reset. ResetData is only valid if ResetStatus is something other then= EFI_SUCCESS. This pointer must be a physical - address. For a ResetType of EfiRestUpdate the data b= uffer also starts with a Null-terminated string - that is followed by a physical VOID * to an EFI_CAPS= ULE_HEADER. - + address. For a ResetType of EfiResetPlatformSpecific= the data buffer also starts with a Null-terminated + string that is followed by an EFI_GUID that describe= s the specific type of reset to perform. **/ VOID EFIAPI EfiResetSystem ( IN EFI_RESET_TYPE ResetType, diff --git a/MdePkg/Include/Uefi/UefiSpec.h b/MdePkg/Include/Uefi/UefiSpec.h index 4c541a6..637c9c7 100644 --- a/MdePkg/Include/Uefi/UefiSpec.h +++ b/MdePkg/Include/Uefi/UefiSpec.h @@ -1018,10 +1018,13 @@ EFI_STATUS The string is a description that the calle= r may use to further indicate the reason for the system reset. = ResetData is only valid if ResetStatus is something other th= an EFI_SUCCESS unless the ResetType is EfiResetPlatformSp= ecific where a minimum amount of ResetData is alw= ays required. + For a ResetType of EfiResetPlatformSpecifi= c the data buffer + also starts with a Null-terminated string = that is followed + by an EFI_GUID that describes the specific= type of reset to perform. **/ typedef VOID (EFIAPI *EFI_RESET_SYSTEM)( IN EFI_RESET_TYPE ResetType, --=20 1.9.5.msysgit.1 _______________________________________________ edk2-devel mailing list edk2-devel@lists.01.org https://lists.01.org/mailman/listinfo/edk2-devel From nobody Thu May 2 05:51:28 2024 Delivered-To: importer@patchew.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; Authentication-Results: mx.zoho.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 1497847641414324.76621174307513; Sun, 18 Jun 2017 21:47:21 -0700 (PDT) Received: from [127.0.0.1] (localhost [IPv6:::1]) by ml01.01.org (Postfix) with ESMTP id 3B7C921C8F63E; Sun, 18 Jun 2017 21:45:58 -0700 (PDT) Received: from mga04.intel.com (mga04.intel.com [192.55.52.120]) (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 ADCFE21C8F618 for ; Sun, 18 Jun 2017 21:45:56 -0700 (PDT) Received: from orsmga002.jf.intel.com ([10.7.209.21]) by fmsmga104.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 18 Jun 2017 21:47:17 -0700 Received: from shwdeopenpsi114.ccr.corp.intel.com ([10.239.157.135]) by orsmga002.jf.intel.com with ESMTP; 18 Jun 2017 21:47:16 -0700 X-Original-To: edk2-devel@lists.01.org X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.39,359,1493708400"; d="scan'208";a="100987305" From: Dandan Bi To: edk2-devel@lists.01.org Date: Mon, 19 Jun 2017 12:46:25 +0800 Message-Id: <1497847586-18144-8-git-send-email-dandan.bi@intel.com> X-Mailer: git-send-email 1.9.5.msysgit.1 In-Reply-To: <1497847586-18144-1-git-send-email-dandan.bi@intel.com> References: <1497847586-18144-1-git-send-email-dandan.bi@intel.com> Subject: [edk2] [PATCH v2 7/8] MdePkg: Clean ACPI 2.0 characters in UEFI spec 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: Star Zeng , Liming Gao 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: Liming Gao Cc: Star Zeng Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Dandan Bi Reviewed-by: Star Zeng to this patch series. --- MdePkg/Include/Protocol/PciIo.h | 25 ++++++++++++------------- MdePkg/Include/Protocol/PciRootBridgeIo.h | 18 +++++++++--------- 2 files changed, 21 insertions(+), 22 deletions(-) diff --git a/MdePkg/Include/Protocol/PciIo.h b/MdePkg/Include/Protocol/PciI= o.h index 6068260..42bcc81 100644 --- a/MdePkg/Include/Protocol/PciIo.h +++ b/MdePkg/Include/Protocol/PciIo.h @@ -1,10 +1,10 @@ /** @file EFI PCI I/O Protocol provides the basic Memory, I/O, PCI configuration,=20 and DMA interfaces that a driver uses to access its PCI controller. =20 - Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.
+ Copyright (c) 2006 - 2017, Intel Corporation. All rights reserved.
This program and the accompanying materials =20 are licensed and made available under the terms and conditions of the BS= D License =20 which accompanies this distribution. The full text of the license may b= e found at =20 http://opensource.org/licenses/bsd-license.php = =20 =20 @@ -446,31 +446,30 @@ EFI_STATUS IN EFI_PCI_IO_PROTOCOL_ATTRIBUTE_OPERATION Operation, IN UINT64 Attributes, OUT UINT64 *Result OPTIONAL ); =20 -/** =20 +/** Gets the attributes that this PCI controller supports setting on a BAR u= sing SetBarAttributes(), and retrieves the list of resource descriptors for a= BAR. - =20 - @param This A pointer to the EFI_PCI_IO_PROTOCOL insta= nce. =20 + + @param This A pointer to the EFI_PCI_IO_PROTOCOL insta= nce. @param BarIndex The BAR index of the standard PCI Configur= ation header to use as the base address for resource range. The legal= range for this field is 0..5. @param Supports A pointer to the mask of attributes that t= his PCI controller supports - setting for this BAR with SetBarAttributes= (). =20 - @param Resources A pointer to the ACPI 2.0 resource descrip= tors that describe the current - configuration of this BAR of the PCI contr= oller. =20 + setting for this BAR with SetBarAttributes= (). + @param Resources A pointer to the resource descriptors that= describe the current + configuration of this BAR of the PCI contr= oller. =20 - @retval EFI_SUCCESS If Supports is not NULL, then the attribut= es that the PCI =20 - controller supports are returned in Suppor= ts. If Resources =20 - is not NULL, then the ACPI 2.0 resource de= scriptors that the PCI - controller is currently using are returned= in Resources. =20 + @retval EFI_SUCCESS If Supports is not NULL, then the attribut= es that the PCI + controller supports are returned in Suppor= ts. If Resources + is not NULL, then the resource descriptors= that the PCI + controller is currently using are returned= in Resources. @retval EFI_INVALID_PARAMETER Both Supports and Attributes are NULL. @retval EFI_UNSUPPORTED BarIndex not valid for this PCI controller. @retval EFI_OUT_OF_RESOURCES There are not enough resources available t= o allocate - Resources. = =20 - =20 + Resources. **/ typedef EFI_STATUS (EFIAPI *EFI_PCI_IO_PROTOCOL_GET_BAR_ATTRIBUTES)( IN EFI_PCI_IO_PROTOCOL *This, diff --git a/MdePkg/Include/Protocol/PciRootBridgeIo.h b/MdePkg/Include/Pro= tocol/PciRootBridgeIo.h index 449dcba..fed5385 100644 --- a/MdePkg/Include/Protocol/PciRootBridgeIo.h +++ b/MdePkg/Include/Protocol/PciRootBridgeIo.h @@ -3,11 +3,11 @@ =20 PCI Root Bridge I/O protocol is used by PCI Bus Driver to perform PCI Me= mory, PCI I/O,=20 and PCI Configuration cycles on a PCI Root Bridge. It also provides serv= ices to perform=20 defferent types of bus mastering DMA. =20 - Copyright (c) 2006 - 2011, Intel Corporation. All rights reserved.
+ Copyright (c) 2006 - 2017, Intel Corporation. All rights reserved.
This program and the accompanying materials =20 are licensed and made available under the terms and conditions of the BS= D License =20 which accompanies this distribution. The full text of the license may b= e found at =20 http://opensource.org/licenses/bsd-license.php = =20 =20 @@ -385,22 +385,22 @@ EFI_STATUS IN OUT UINT64 *ResourceBase, IN OUT UINT64 *ResourceLength ); =20 /** =20 - Retrieves the current resource settings of this PCI root bridge in the f= orm of a set of ACPI 2.0 - resource descriptors. = =20 + Retrieves the current resource settings of this PCI root bridge in the f= orm of a set of ACPI + resource descriptors. =20 @param This A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PR= OTOCOL. - @param Resources A pointer to the ACPI 2.0 resource descrip= tors that describe the current - configuration of this PCI root bridge. = =20 - =20 + @param Resources A pointer to the resource descriptors that= describe the current + configuration of this PCI root bridge. + @retval EFI_SUCCESS The current configuration of this PCI root= bridge was returned in - Resources. = = =20 + Resources. @retval EFI_UNSUPPORTED The current configuration of this PCI root= bridge could not be - retrieved. = =20 - =20 + retrieved. + **/ typedef EFI_STATUS (EFIAPI *EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_CONFIGURATION)( IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL *This, --=20 1.9.5.msysgit.1 _______________________________________________ edk2-devel mailing list edk2-devel@lists.01.org https://lists.01.org/mailman/listinfo/edk2-devel From nobody Thu May 2 05:51:28 2024 Delivered-To: importer@patchew.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; Authentication-Results: mx.zoho.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 149784764431965.88253124970038; Sun, 18 Jun 2017 21:47:24 -0700 (PDT) Received: from [127.0.0.1] (localhost [IPv6:::1]) by ml01.01.org (Postfix) with ESMTP id 7F12320945549; Sun, 18 Jun 2017 21:46:01 -0700 (PDT) Received: from mga04.intel.com (mga04.intel.com [192.55.52.120]) (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 1FFED21C8F618 for ; Sun, 18 Jun 2017 21:46:01 -0700 (PDT) Received: from orsmga002.jf.intel.com ([10.7.209.21]) by fmsmga104.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 18 Jun 2017 21:47:22 -0700 Received: from shwdeopenpsi114.ccr.corp.intel.com ([10.239.157.135]) by orsmga002.jf.intel.com with ESMTP; 18 Jun 2017 21:47:21 -0700 X-Original-To: edk2-devel@lists.01.org X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.39,359,1493708400"; d="scan'208";a="100987317" From: Dandan Bi To: edk2-devel@lists.01.org Date: Mon, 19 Jun 2017 12:46:26 +0800 Message-Id: <1497847586-18144-9-git-send-email-dandan.bi@intel.com> X-Mailer: git-send-email 1.9.5.msysgit.1 In-Reply-To: <1497847586-18144-1-git-send-email-dandan.bi@intel.com> References: <1497847586-18144-1-git-send-email-dandan.bi@intel.com> Subject: [edk2] [PATCH v2 8/8] MdeModulePkg: Clean ACPI 2.0 characters in UEFI spec 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: Star Zeng , Liming Gao 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" v2: Add some missing changes. Cc: Liming Gao Cc: Star Zeng Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Dandan Bi Reviewed-by: Star Zeng to this patch series. --- MdeModulePkg/Bus/Pci/PciBusDxe/PciIo.c | 6 +++--- MdeModulePkg/Bus/Pci/PciBusDxe/PciIo.h | 6 +++--- MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridge.h | 6 +++--- MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridgeIo.c | 15 +++++++------= -- 4 files changed, 16 insertions(+), 17 deletions(-) diff --git a/MdeModulePkg/Bus/Pci/PciBusDxe/PciIo.c b/MdeModulePkg/Bus/Pci/= PciBusDxe/PciIo.c index 3b3b53a..cc7125e 100644 --- a/MdeModulePkg/Bus/Pci/PciBusDxe/PciIo.c +++ b/MdeModulePkg/Bus/Pci/PciBusDxe/PciIo.c @@ -1,9 +1,9 @@ /** @file EFI PCI IO protocol functions implementation for PCI Bus module. =20 -Copyright (c) 2006 - 2016, Intel Corporation. All rights reserved.
+Copyright (c) 2006 - 2017, Intel Corporation. All rights reserved.
This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD = License which accompanies this distribution. The full text of the license may be = found at http://opensource.org/licenses/bsd-license.php =20 @@ -1836,16 +1836,16 @@ GetMmioAddressTranslationOffset ( @param This A pointer to the EFI_PCI_IO_PROTOCOL insta= nce. @param BarIndex The BAR index of the standard PCI Configur= ation header to use as the base address for resource range. The legal= range for this field is 0..5. @param Supports A pointer to the mask of attributes that t= his PCI controller supports setting for this BAR with SetBarAttributes= (). - @param Resources A pointer to the ACPI 2.0 resource descrip= tors that describe the current + @param Resources A pointer to the resource descriptors that= describe the current configuration of this BAR of the PCI contr= oller. =20 @retval EFI_SUCCESS If Supports is not NULL, then the attribut= es that the PCI controller supports are returned in Suppor= ts. If Resources - is not NULL, then the ACPI 2.0 resource de= scriptors that the PCI + is not NULL, then the resource descriptors= that the PCI controller is currently using are returned= in Resources. @retval EFI_INVALID_PARAMETER Both Supports and Attributes are NULL. @retval EFI_UNSUPPORTED BarIndex not valid for this PCI controller. @retval EFI_OUT_OF_RESOURCES There are not enough resources available t= o allocate Resources. diff --git a/MdeModulePkg/Bus/Pci/PciBusDxe/PciIo.h b/MdeModulePkg/Bus/Pci/= PciBusDxe/PciIo.h index ac2def5..da3de39 100644 --- a/MdeModulePkg/Bus/Pci/PciBusDxe/PciIo.h +++ b/MdeModulePkg/Bus/Pci/PciBusDxe/PciIo.h @@ -1,9 +1,9 @@ /** @file EFI PCI IO protocol functions declaration for PCI Bus module. =20 -Copyright (c) 2006 - 2009, Intel Corporation. All rights reserved.
+Copyright (c) 2006 - 2017, Intel Corporation. All rights reserved.
This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD = License which accompanies this distribution. The full text of the license may be = found at http://opensource.org/licenses/bsd-license.php =20 @@ -588,16 +588,16 @@ PciIoAttributes ( @param This A pointer to the EFI_PCI_IO_PROTOCOL insta= nce. @param BarIndex The BAR index of the standard PCI Configur= ation header to use as the base address for resource range. The legal= range for this field is 0..5. @param Supports A pointer to the mask of attributes that t= his PCI controller supports setting for this BAR with SetBarAttributes= (). - @param Resources A pointer to the ACPI 2.0 resource descrip= tors that describe the current + @param Resources A pointer to the resource descriptors that= describe the current configuration of this BAR of the PCI contr= oller. =20 @retval EFI_SUCCESS If Supports is not NULL, then the attribut= es that the PCI controller supports are returned in Suppor= ts. If Resources - is not NULL, then the ACPI 2.0 resource de= scriptors that the PCI + is not NULL, then the resource descriptors= that the PCI controller is currently using are returned= in Resources. @retval EFI_INVALID_PARAMETER Both Supports and Attributes are NULL. @retval EFI_UNSUPPORTED BarIndex not valid for this PCI controller. @retval EFI_OUT_OF_RESOURCES There are not enough resources available t= o allocate Resources. diff --git a/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridge.h b/MdeMod= ulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridge.h index 1fec88b..d3dfb57 100644 --- a/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridge.h +++ b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridge.h @@ -1,10 +1,10 @@ /** @file =20 The PCI Root Bridge header file. =20 -Copyright (c) 1999 - 2016, Intel Corporation. All rights reserved.
+Copyright (c) 1999 - 2017, Intel Corporation. All rights reserved.
This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD = License which accompanies this distribution. The full text of the license may be = found at http://opensource.org/licenses/bsd-license.php =20 @@ -552,14 +552,14 @@ RootBridgeIoSetAttributes ( ; =20 /** =20 Retrieves the current resource settings of this PCI root bridge - in the form of a set of ACPI 2.0 resource descriptor. + in the form of a set of ACPI resource descriptor. =20 @param This - Pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL inst= ance. - @param Resources - Pointer to the ACPI 2.0 resource descriptor that + @param Resources - Pointer to the resource descriptor that describe the current configuration of this PCI root bridge. =20 @retval EFI_SUCCESS - Success. @retval EFI_UNSUPPORTED - Current configuration of the PCI root bridge diff --git a/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridgeIo.c b/MdeM= odulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridgeIo.c index 8e4f032..dc06c16 100644 --- a/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridgeIo.c +++ b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridgeIo.c @@ -1558,24 +1558,23 @@ RootBridgeIoSetAttributes ( return EFI_SUCCESS; } =20 /** Retrieves the current resource settings of this PCI root bridge in the f= orm - of a set of ACPI 2.0 resource descriptors. + of a set of ACPI resource descriptors. =20 There are only two resource descriptor types from the ACPI Specification= that may be used to describe the current resources allocated to a PCI root br= idge. - These are the QWORD Address Space Descriptor (ACPI 2.0 Section 6.4.3.5.1= ), - and the End Tag (ACPI 2.0 Section 6.4.2.8). The QWORD Address Space - Descriptor can describe memory, I/O, and bus number ranges for dynamic or - fixed resources. The configuration of a PCI root bridge is described wit= h one - or more QWORD Address Space Descriptors followed by an End Tag. + These are the QWORD Address Space Descriptor, and the End Tag. The QWORD + Address Space Descriptor can describe memory, I/O, and bus number ranges= for + dynamic or fixed resources. The configuration of a PCI root bridge is de= scribed + with one or more QWORD Address Space Descriptors followed by an End Tag. =20 @param[in] This A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCO= L. - @param[out] Resources A pointer to the ACPI 2.0 resource descriptors = that + @param[out] Resources A pointer to the resource descriptors that describe the current configuration of this PCI = root - bridge. The storage for the ACPI 2.0 resource + bridge. The storage for the resource descriptors is allocated by this function. The caller must treat the return buffer as read-only data, and the buffer must not be freed by the caller. =20 --=20 1.9.5.msysgit.1 _______________________________________________ edk2-devel mailing list edk2-devel@lists.01.org https://lists.01.org/mailman/listinfo/edk2-devel