IntelFrameworkModulePkg: Clean up source files

[mirror_edk2.git] / IntelFrameworkModulePkg / Universal / Console / VgaClassDxe / VgaClass.c

diff --git a/IntelFrameworkModulePkg/Universal/Console/VgaClassDxe/VgaClass.c b/IntelFrameworkModulePkg/Universal/Console/VgaClassDxe/VgaClass.c
index 2d672797fa942535e37ced9d6bdd07d5af246b98..a9da74c7920eeb8161abbbfc682de0b711108a9c 100644 (file)
--- a/IntelFrameworkModulePkg/Universal/Console/VgaClassDxe/VgaClass.c
+++ b/IntelFrameworkModulePkg/Universal/Console/VgaClassDxe/VgaClass.c
@@ -1,14 +1,14 @@
 /** @file\r
   VGA Class Driver that managers VGA devices and produces Simple Text Output Protocol.\r
 \r
 /** @file\r
   VGA Class Driver that managers VGA devices and produces Simple Text Output Protocol.\r
 \r

-Copyright (c) 2006 - 2009, Intel Corporation. All rights reserved.<BR>\r
-This program and the accompanying materials                          \r
-are licensed and made available under the terms and conditions of the BSD License         \r
-which accompanies this distribution.  The full text of the license may be found at        \r
-http://opensource.org/licenses/bsd-license.php                                            \r
-                                                                                          \r
-THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     \r
-WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             \r
+Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>\r
+This program and the accompanying materials\r
+are licensed and made available under the terms and conditions of the BSD License\r
+which accompanies this distribution.  The full text of the license may be found at\r
+http://opensource.org/licenses/bsd-license.php\r
+\r
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r

 \r
 **/\r
 \r
 \r
 **/\r
 \r


@@ -310,7 +310,7 @@ UNICODE_TO_CHAR  UnicodeToPcAnsiOrAscii[] = {
 \r
   @param  ImageHandle       The firmware allocated handle for the EFI image.\r
   @param  SystemTable       A pointer to the EFI System Table.\r
 \r
   @param  ImageHandle       The firmware allocated handle for the EFI image.\r
   @param  SystemTable       A pointer to the EFI System Table.\r

-  \r
+\r

   @retval EFI_SUCCESS       The entry point is executed successfully.\r
 \r
 **/\r
   @retval EFI_SUCCESS       The entry point is executed successfully.\r
 \r
 **/\r


@@ -341,7 +341,7 @@ InitializeVgaClass(
 \r
 /**\r
   Internal worker function to program CRTC register via PCI I/O Protocol.\r
 \r
 /**\r
   Internal worker function to program CRTC register via PCI I/O Protocol.\r

-  \r
+\r

   @param VgaClassDev  device instance object\r
   @param Address      Address of register to write\r
   @param Data         Data to write to register.\r
   @param VgaClassDev  device instance object\r
   @param Address      Address of register to write\r
   @param Data         Data to write to register.\r


@@ -375,12 +375,12 @@ WriteCrtc (
 \r
 /**\r
   Internal worker function to set cursor's position to VgaClass device\r
 \r
 /**\r
   Internal worker function to set cursor's position to VgaClass device\r

-  \r
+\r

   @param  VgaClassDev   Private data structure for device instance.\r
   @param  Column        Colomn of position to set cursor to.\r
   @param  Row           Row of position to set cursor to.\r
   @param  MaxColumn     Max value of column.\r
   @param  VgaClassDev   Private data structure for device instance.\r
   @param  Column        Colomn of position to set cursor to.\r
   @param  Row           Row of position to set cursor to.\r
   @param  MaxColumn     Max value of column.\r

-  \r
+\r

 **/\r
 VOID\r
 SetVideoCursorPosition (\r
 **/\r
 VOID\r
 SetVideoCursorPosition (\r


@@ -461,7 +461,7 @@ LibIsValidTextGraphics (
 \r
 /**\r
   Internal worker function to check whether input value is an ASCII char.\r
 \r
 /**\r
   Internal worker function to check whether input value is an ASCII char.\r

-  \r
+\r

   @param  Char     Character to check.\r
 \r
   @retval TRUE     Input value is an ASCII char.\r
   @param  Char     Character to check.\r
 \r
   @retval TRUE     Input value is an ASCII char.\r


@@ -482,7 +482,7 @@ IsValidAscii (
 \r
 /**\r
   Internal worker function to check whether input value is a unicode control char.\r
 \r
 /**\r
   Internal worker function to check whether input value is a unicode control char.\r

-  \r
+\r

   @param  Char    Character to check.\r
 \r
   @retval TRUE     Input value is a unicode control char.\r
   @param  Char    Character to check.\r
 \r
   @retval TRUE     Input value is a unicode control char.\r


@@ -712,7 +712,7 @@ ErrorExit:
 \r
 /**\r
   Starts the device controller.\r
 \r
 /**\r
   Starts the device controller.\r

-  \r
+\r

   This function implments EFI_DRIVER_BINDING_PROTOCOL.Stop().\r
   It stops this driver on Controller. Support stopping any child handles\r
   created by this driver.\r
   This function implments EFI_DRIVER_BINDING_PROTOCOL.Stop().\r
   It stops this driver on Controller. Support stopping any child handles\r
   created by this driver.\r


@@ -798,7 +798,7 @@ VgaClassDriverBindingStop (
   This function implements EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL.Reset().\r
   It resets the text output device hardware. The cursor position is set to (0, 0),\r
   and the screen is cleared to the default background color for the output device.\r
   This function implements EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL.Reset().\r
   It resets the text output device hardware. The cursor position is set to (0, 0),\r
   and the screen is cleared to the default background color for the output device.\r

-  \r
+\r

   @param  This                 Pointer to EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL instance.\r
   @param  ExtendedVerification Indicates that the driver may perform a more exhaustive\r
                                verification operation of the device during reset.\r
   @param  This                 Pointer to EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL instance.\r
   @param  ExtendedVerification Indicates that the driver may perform a more exhaustive\r
                                verification operation of the device during reset.\r


@@ -837,7 +837,7 @@ VgaClassReset (
 \r
 /**\r
   Writes a Unicode string to the output device.\r
 \r
 /**\r
   Writes a Unicode string to the output device.\r

-  \r
+\r

   This function implements EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL.OutputString().\r
   It writes a Unicode string to the output device. This is the most basic output mechanism\r
   on an output device.\r
   This function implements EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL.OutputString().\r
   It writes a Unicode string to the output device. This is the most basic output mechanism\r
   on an output device.\r


@@ -977,7 +977,7 @@ VgaClassOutputString (
 \r
 /**\r
   Verifies that all characters in a Unicode string can be output to the target device.\r
 \r
 /**\r
   Verifies that all characters in a Unicode string can be output to the target device.\r

-  \r
+\r

   This function implements EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL.TestString().\r
   It verifies that all characters in a Unicode string can be output to the target device.\r
 \r
   This function implements EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL.TestString().\r
   It verifies that all characters in a Unicode string can be output to the target device.\r
 \r


@@ -1009,13 +1009,13 @@ VgaClassTestString (
 \r
 /**\r
   Clears the output device(s) display to the currently selected background color.\r
 \r
 /**\r
   Clears the output device(s) display to the currently selected background color.\r

-  \r
+\r

   This function implements EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL.ClearScreen().\r
   The ClearScreen() function clears the output device(s) display to the currently\r
   selected background color. The cursor position is set to (0, 0).\r
 \r
   @param  This                   Pointer to EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL instance.\r
   This function implements EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL.ClearScreen().\r
   The ClearScreen() function clears the output device(s) display to the currently\r
   selected background color. The cursor position is set to (0, 0).\r
 \r
   @param  This                   Pointer to EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL instance.\r

-  \r
+\r

   @retval EFI_SUCESS             The operation completed successfully.\r
   @retval EFI_DEVICE_ERROR       The device had an error and could not complete the request.\r
   @retval EFI_UNSUPPORTED        The output device is not in a valid text mode.\r
   @retval EFI_SUCESS             The operation completed successfully.\r
   @retval EFI_DEVICE_ERROR       The device had an error and could not complete the request.\r
   @retval EFI_UNSUPPORTED        The output device is not in a valid text mode.\r


@@ -1063,7 +1063,7 @@ VgaClassClearScreen (
 \r
 /**\r
   Sets the background and foreground colors for theOutputString() and ClearScreen() functions.\r
 \r
 /**\r
   Sets the background and foreground colors for theOutputString() and ClearScreen() functions.\r

-  \r
+\r

   This function implements EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL.SetAttribute().\r
   It sets the background and foreground colors for the OutputString() and ClearScreen() functions.\r
   The color mask can be set even when the device is in an invalid text mode.\r
   This function implements EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL.SetAttribute().\r
   It sets the background and foreground colors for the OutputString() and ClearScreen() functions.\r
   The color mask can be set even when the device is in an invalid text mode.\r


@@ -1074,7 +1074,7 @@ VgaClassClearScreen (
   @param  Attribute              The attribute to set.\r
                                  Bits 0..3 are the foreground color,\r
                                  and bits 4..6 are the background color.\r
   @param  Attribute              The attribute to set.\r
                                  Bits 0..3 are the foreground color,\r
                                  and bits 4..6 are the background color.\r

-  \r
+\r

   @retval EFI_SUCCESS            The requested attributes were set.\r
   @retval EFI_DEVICE_ERROR       The device had an error and could not complete the request.\r
 \r
   @retval EFI_SUCCESS            The requested attributes were set.\r
   @retval EFI_DEVICE_ERROR       The device had an error and could not complete the request.\r
 \r


@@ -1096,15 +1096,15 @@ VgaClassSetAttribute (
 \r
 /**\r
   Sets the current coordinates of the cursor position.\r
 \r
 /**\r
   Sets the current coordinates of the cursor position.\r

-  \r
+\r

   This function implements EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL.SetCursorPosition().\r
   It sets the current coordinates of the cursor position.\r
   The upper left corner of the screen is defined as coordinate (0, 0).\r
   This function implements EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL.SetCursorPosition().\r
   It sets the current coordinates of the cursor position.\r
   The upper left corner of the screen is defined as coordinate (0, 0).\r

-  \r
+\r

   @param  This                   Pointer to EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL instance.\r
   @param  Column                 Column of position to set the cursor to.\r
   @param  Row                    Row of position to set the cursor to.\r
   @param  This                   Pointer to EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL instance.\r
   @param  Column                 Column of position to set the cursor to.\r
   @param  Row                    Row of position to set the cursor to.\r

-  \r
+\r

   @retval EFI_SUCCESS            The operation completed successfully.\r
   @retval EFI_DEVICE_ERROR       The device had an error and could not complete the request.\r
   @retval EFI_UNSUPPORTED        The output device is not in a valid text mode, or the cursor\r
   @retval EFI_SUCCESS            The operation completed successfully.\r
   @retval EFI_DEVICE_ERROR       The device had an error and could not complete the request.\r
   @retval EFI_UNSUPPORTED        The output device is not in a valid text mode, or the cursor\r


@@ -1150,14 +1150,14 @@ VgaClassSetCursorPosition (
 \r
 /**\r
   Makes the cursor visible or invisible.\r
 \r
 /**\r
   Makes the cursor visible or invisible.\r

-  \r
+\r

   This function implements EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL.EnableCursor().\r
   It makes the cursor visible or invisible.\r
 \r
   @param  This                   Pointer to EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL instance.\r
   @param  Visible                If TRUE, the cursor is set to be visible.\r
                                  If FALSE, the cursor is set to be invisible.\r
   This function implements EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL.EnableCursor().\r
   It makes the cursor visible or invisible.\r
 \r
   @param  This                   Pointer to EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL instance.\r
   @param  Visible                If TRUE, the cursor is set to be visible.\r
                                  If FALSE, the cursor is set to be invisible.\r

-  \r
+\r

   @retval EFI_SUCESS             The operation completed successfully.\r
   @retval EFI_DEVICE_ERROR       The device had an error and could not complete the request or the\r
                                  device does not support changing the cursor mode.\r
   @retval EFI_SUCESS             The operation completed successfully.\r
   @retval EFI_DEVICE_ERROR       The device had an error and could not complete the request or the\r
                                  device does not support changing the cursor mode.\r


@@ -1208,7 +1208,7 @@ VgaClassEnableCursor (
   @param  ModeNumber             The mode number to return information on.\r
   @param  Columns                Columen in current mode number\r
   @param  Rows                   Row in current mode number.\r
   @param  ModeNumber             The mode number to return information on.\r
   @param  Columns                Columen in current mode number\r
   @param  Rows                   Row in current mode number.\r

-  \r
+\r

   @retval EFI_SUCCESS            The requested mode information was returned.\r
   @retval EFI_DEVICE_ERROR       The device had an error and could not complete the request.\r
   @retval EFI_UNSUPPORTED        The mode number was not valid.\r
   @retval EFI_SUCCESS            The requested mode information was returned.\r
   @retval EFI_DEVICE_ERROR       The device had an error and could not complete the request.\r
   @retval EFI_UNSUPPORTED        The mode number was not valid.\r


@@ -1251,7 +1251,7 @@ VgaClassQueryMode (
 \r
 /**\r
   Sets the output device(s) to a specified mode.\r
 \r
 /**\r
   Sets the output device(s) to a specified mode.\r

-  \r
+\r

   This function implements EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL.QueryMode().\r
   It sets the output device(s) to the requested mode.\r
   On success the device is in the geometry for the requested mode,\r
   This function implements EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL.QueryMode().\r
   It sets the output device(s) to the requested mode.\r
   On success the device is in the geometry for the requested mode,\r


@@ -1259,7 +1259,7 @@ VgaClassQueryMode (
 \r
   @param  This                   Pointer to EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL instance.\r
   @param  ModeNumber             The text mode to set.\r
 \r
   @param  This                   Pointer to EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL instance.\r
   @param  ModeNumber             The text mode to set.\r

-  \r
+\r

   @retval EFI_SUCCESS            The requested text mode was set.\r
   @retval EFI_DEVICE_ERROR       The device had an error and could not complete the request.\r
   @retval EFI_UNSUPPORTED        The mode number was not valid.\r
   @retval EFI_SUCCESS            The requested text mode was set.\r
   @retval EFI_DEVICE_ERROR       The device had an error and could not complete the request.\r
   @retval EFI_UNSUPPORTED        The mode number was not valid.\r