Add details comments for the code flow to initialize Unicode Collation (2) support. master origin/HEAD origin/master
authorqhuang8 <qhuang8@65ba2f78-6c18-0410-a7b4-885970cf29fa>
Fri, 10 Oct 2008 02:33:21 +0000 (02:33 +0000)
committerqhuang8 <qhuang8@65ba2f78-6c18-0410-a7b4-885970cf29fa>
Fri, 10 Oct 2008 02:33:21 +0000 (02:33 +0000)
git-svn-id: https://fat-driver2.tianocore.org/svn/fat-driver2/trunk@29 65ba2f78-6c18-0410-a7b4-885970cf29fa

FatPkg/EnhancedFatDxe/UnicodeCollation.c

index 4a849af..9e5db7b 100644 (file)
@@ -162,6 +162,12 @@ InitializeUnicodeCollationSupportWithConfig (
 /**\r
   Initialize Unicode Collation support.\r
 \r
 /**\r
   Initialize Unicode Collation support.\r
 \r
+  This function searches Initialized Unicode Collation support based on PCDs:\r
+  PcdUnicodeCollation2Support and PcdUnicodeCollationSupport.\r
+  It first tries to locate Unicode Collation 2 protocol and matches it with current\r
+  platform language code. If for any reason the first attempt fails, it then tries to\r
+  use Unicode Collation Protocol.\r
+\r
   @param  AgentHandle          The handle used to open Unicode Collation (2) protocol.\r
 \r
   @retval EFI_SUCCESS          The Unicode Collation (2) protocol has been successfully located.\r
   @param  AgentHandle          The handle used to open Unicode Collation (2) protocol.\r
 \r
   @retval EFI_SUCCESS          The Unicode Collation (2) protocol has been successfully located.\r
@@ -177,10 +183,18 @@ InitializeUnicodeCollationSupport (
   EFI_STATUS       Status;\r
 \r
   Status = EFI_UNSUPPORTED;\r
   EFI_STATUS       Status;\r
 \r
   Status = EFI_UNSUPPORTED;\r
+\r
+  //\r
+  // First try to use RFC 3066 Unicode Collation 2 Protocol.\r
+  //\r
   if (FeaturePcdGet (PcdUnicodeCollation2Support)) {\r
     Status = InitializeUnicodeCollationSupportWithConfig (AgentHandle, &mRfc3066Lang);\r
   }\r
 \r
   if (FeaturePcdGet (PcdUnicodeCollation2Support)) {\r
     Status = InitializeUnicodeCollationSupportWithConfig (AgentHandle, &mRfc3066Lang);\r
   }\r
 \r
+  //\r
+  // If the attempt to use Unicode Collation 2 Protocol fails, then we fall back\r
+  // on the ISO 639-2 Unicode Collation Protocol.\r
+  //\r
   if (FeaturePcdGet (PcdUnicodeCollationSupport) && EFI_ERROR (Status)) {\r
     Status = InitializeUnicodeCollationSupportWithConfig (AgentHandle, &mIso639Lang);\r
   }\r
   if (FeaturePcdGet (PcdUnicodeCollationSupport) && EFI_ERROR (Status)) {\r
     Status = InitializeUnicodeCollationSupportWithConfig (AgentHandle, &mIso639Lang);\r
   }\r