1)update function header coding style issue

[mirror_edk2.git] / MdePkg / Include / Protocol / ComponentName2.h

diff --git a/MdePkg/Include/Protocol/ComponentName2.h b/MdePkg/Include/Protocol/ComponentName2.h
index d9fc6e18e32f594beba4a82fafebc4f8be5de464..8da532d6eb8ca2cc127be6dfafc97be08f1d5ffe 100644 (file)
--- a/MdePkg/Include/Protocol/ComponentName2.h
+++ b/MdePkg/Include/Protocol/ComponentName2.h
@@ -1,7 +1,9 @@
 /** @file\r
-  EFI Component Name 2 Protocol\r
+  UEFI Component Name 2 Protocol as defined in the UEFI 2.1 specification.\r
+  This protocol is used to retrieve user readable names of drivers \r
+  and controllers managed by UEFI Drivers.\r
 \r
-  Copyright (c) 2006 - 2007, Intel Corporation\r
+  Copyright (c) 2006 - 2008, Intel Corporation\r
   All rights reserved. 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
@@ -15,11 +17,9 @@
 #ifndef __EFI_COMPONENT_NAME2_H__\r
 #define __EFI_COMPONENT_NAME2_H__\r
 \r
-#include <PiDxe.h>\r
-\r
-//\r
-// Global ID for the Component Name Protocol\r
-//\r
+///\r
+/// Global ID for the Component Name Protocol\r
+///\r
 #define EFI_COMPONENT_NAME2_PROTOCOL_GUID \\r
   {0x6a7a5cff, 0xe8d9, 0x4f70, { 0xba, 0xda, 0x75, 0xab, 0x30, 0x25, 0xce, 0x14 } }\r
 \r
@@ -31,7 +31,7 @@ typedef struct _EFI_COMPONENT_NAME2_PROTOCOL  EFI_COMPONENT_NAME2_PROTOCOL;
   the EFI Driver.\r
 \r
   @param  This       A pointer to the\r
-                     EFI_COMPONENT_NAME_PROTOCOL instance.\r
+                     EFI_COMPONENT_NAME2_PROTOCOL instance.\r
   \r
   @param  Language   A pointer to a Null-terminated ASCII string\r
                      array indicating the language. This is the\r
@@ -64,7 +64,7 @@ typedef struct _EFI_COMPONENT_NAME2_PROTOCOL  EFI_COMPONENT_NAME2_PROTOCOL;
 **/\r
 typedef\r
 EFI_STATUS\r
-(EFIAPI *EFI_COMPONENT_NAME2_GET_DRIVER_NAME) (\r
+(EFIAPI *EFI_COMPONENT_NAME2_GET_DRIVER_NAME)(\r
   IN EFI_COMPONENT_NAME2_PROTOCOL          *This,\r
   IN  CHAR8                                *Language,\r
   OUT CHAR16                               **DriverName\r
@@ -76,7 +76,7 @@ EFI_STATUS
   the controller that is being managed by an EFI Driver.\r
 \r
   @param  This             A pointer to the\r
-                           EFI_COMPONENT_NAME_PROTOCOL instance.\r
+                           EFI_COMPONENT_NAME2_PROTOCOL instance.\r
 \r
   @param  ControllerHandle The handle of a controller that the\r
                            driver specified by This is managing.\r
@@ -143,7 +143,7 @@ EFI_STATUS
 **/\r
 typedef\r
 EFI_STATUS\r
-(EFIAPI *EFI_COMPONENT_NAME2_GET_CONTROLLER_NAME) (\r
+(EFIAPI *EFI_COMPONENT_NAME2_GET_CONTROLLER_NAME)(\r
   IN EFI_COMPONENT_NAME2_PROTOCOL *This,\r
   IN  EFI_HANDLE                  ControllerHandle,\r
   IN  EFI_HANDLE                  ChildHandle        OPTIONAL,\r
@@ -151,12 +151,21 @@ EFI_STATUS
   OUT CHAR16                      **ControllerName\r
   );\r
 \r
-//\r
-// Interface structure for the Component Name Protocol\r
-//\r
+///\r
+/// This protocol is used to retrieve user readable names of drivers \r
+/// and controllers managed by UEFI Drivers.\r
+///\r
 struct _EFI_COMPONENT_NAME2_PROTOCOL {\r
   EFI_COMPONENT_NAME2_GET_DRIVER_NAME      GetDriverName;\r
   EFI_COMPONENT_NAME2_GET_CONTROLLER_NAME  GetControllerName;\r
+\r
+  ///\r
+  /// A Null-terminated ASCII string array that contains one or more\r
+  /// supported language codes. This is the list of language codes that\r
+  /// this protocol supports. The number of languages supported by a\r
+  /// driver is up to the driver writer. SupportedLanguages is\r
+  /// specified in RFC 3066 format.  \r
+  ///\r
   CHAR8                                    *SupportedLanguages;\r
 };\r
 \r