]> git.proxmox.com Git - mirror_edk2.git/blobdiff - MdePkg/Library/BasePcdLibNull/PcdLib.c
MdePkg: Apply uncrustify changes
[mirror_edk2.git] / MdePkg / Library / BasePcdLibNull / PcdLib.c
index 669af6484a198ce2116dd39218f7a1cb838408c7..a214371c3fdfa046e62126d58af2817b60f8c7cc 100644 (file)
@@ -1,14 +1,8 @@
 /** @file\r
   A emptry template implementation of PCD Library.\r
 \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
-  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
+  SPDX-License-Identifier: BSD-2-Clause-Patent\r
 \r
 **/\r
 \r
 #include <Library/PcdLib.h>\r
 #include <Library/BaseMemoryLib.h>\r
 \r
-\r
 /**\r
+  This function provides a means by which SKU support can be established in the PCD infrastructure.\r
+\r
   Sets the current SKU in the PCD database to the value specified by SkuId.  SkuId is returned.\r
 \r
-  @param[in]  SkuId The SKU value that will be used when the PCD service will retrieve and \r
-              set values associated with a PCD token.\r
+  @param[in]  SkuId The SKU value that will be used when the PCD service will retrieve and\r
+                    set values associated with a PCD token.\r
 \r
   @return Return the SKU ID that just be set.\r
 \r
 **/\r
-UINTN           \r
+UINTN\r
 EFIAPI\r
 LibPcdSetSku (\r
   IN UINTN  SkuId\r
@@ -40,17 +35,19 @@ LibPcdSetSku (
 }\r
 \r
 /**\r
-  Returns the 8-bit value for the token specified by TokenNumber. \r
+  This function provides a means by which to retrieve a value for a given PCD token.\r
+\r
+  Returns the 8-bit value for the token specified by TokenNumber.\r
 \r
   @param[in]  TokenNumber The PCD token number to retrieve a current value for.\r
 \r
-  @return Returns the 8-bit value for the token specified by TokenNumber. \r
+  @return Returns the 8-bit value for the token specified by TokenNumber.\r
 \r
 **/\r
 UINT8\r
 EFIAPI\r
 LibPcdGet8 (\r
-  IN UINTN             TokenNumber\r
+  IN UINTN  TokenNumber\r
   )\r
 {\r
   ASSERT (FALSE);\r
@@ -58,20 +55,20 @@ LibPcdGet8 (
   return 0;\r
 }\r
 \r
-\r
-\r
 /**\r
-  Returns the 16-bit value for the token specified by TokenNumber. \r
+  This function provides a means by which to retrieve a value for a given PCD token.\r
 \r
-  @param[in] TokenNumber The PCD token number to retrieve a current value for.\r
+  Returns the 16-bit value for the token specified by TokenNumber.\r
+\r
+  @param[in]  TokenNumber The PCD token number to retrieve a current value for.\r
 \r
-  @return Returns the 16-bit value for the token specified by TokenNumber. \r
+  @return Returns the 16-bit value for the token specified by TokenNumber.\r
 \r
 **/\r
 UINT16\r
 EFIAPI\r
 LibPcdGet16 (\r
-  IN UINTN             TokenNumber\r
+  IN UINTN  TokenNumber\r
   )\r
 {\r
   ASSERT (FALSE);\r
@@ -79,10 +76,10 @@ LibPcdGet16 (
   return 0;\r
 }\r
 \r
-\r
-\r
 /**\r
-  Returns the 32-bit value for the token specified by TokenNumber. \r
+  This function provides a means by which to retrieve a value for a given PCD token.\r
+\r
+  Returns the 32-bit value for the token specified by TokenNumber.\r
 \r
   @param[in]  TokenNumber The PCD token number to retrieve a current value for.\r
 \r
@@ -92,7 +89,7 @@ LibPcdGet16 (
 UINT32\r
 EFIAPI\r
 LibPcdGet32 (\r
-  IN UINTN             TokenNumber\r
+  IN UINTN  TokenNumber\r
   )\r
 {\r
   ASSERT (FALSE);\r
@@ -100,9 +97,9 @@ LibPcdGet32 (
   return 0;\r
 }\r
 \r
-\r
-\r
 /**\r
+  This function provides a means by which to retrieve a value for a given PCD token.\r
+\r
   Returns the 64-bit value for the token specified by TokenNumber.\r
 \r
   @param[in]  TokenNumber The PCD token number to retrieve a current value for.\r
@@ -113,7 +110,7 @@ LibPcdGet32 (
 UINT64\r
 EFIAPI\r
 LibPcdGet64 (\r
-  IN UINTN             TokenNumber\r
+  IN UINTN  TokenNumber\r
   )\r
 {\r
   ASSERT (FALSE);\r
@@ -121,9 +118,9 @@ LibPcdGet64 (
   return 0;\r
 }\r
 \r
-\r
-\r
 /**\r
+  This function provides a means by which to retrieve a value for a given PCD token.\r
+\r
   Returns the pointer to the buffer of the token specified by TokenNumber.\r
 \r
   @param[in]  TokenNumber The PCD token number to retrieve a current value for.\r
@@ -134,7 +131,7 @@ LibPcdGet64 (
 VOID *\r
 EFIAPI\r
 LibPcdGetPtr (\r
-  IN UINTN             TokenNumber\r
+  IN UINTN  TokenNumber\r
   )\r
 {\r
   ASSERT (FALSE);\r
@@ -142,20 +139,20 @@ LibPcdGetPtr (
   return 0;\r
 }\r
 \r
-\r
-\r
 /**\r
-  Returns the Boolean value of the token specified by TokenNumber. \r
+  This function provides a means by which to retrieve a value for a given PCD token.\r
+\r
+  Returns the Boolean value of the token specified by TokenNumber.\r
 \r
   @param[in]  TokenNumber The PCD token number to retrieve a current value for.\r
 \r
-  @return Returns the Boolean value of the token specified by TokenNumber. \r
+  @return Returns the Boolean value of the token specified by TokenNumber.\r
 \r
 **/\r
-BOOLEAN \r
+BOOLEAN\r
 EFIAPI\r
 LibPcdGetBool (\r
-  IN UINTN             TokenNumber\r
+  IN UINTN  TokenNumber\r
   )\r
 {\r
   ASSERT (FALSE);\r
@@ -163,20 +160,18 @@ LibPcdGetBool (
   return 0;\r
 }\r
 \r
-\r
-\r
 /**\r
-  Returns the size of the token specified by TokenNumber. \r
+  This function provides a means by which to retrieve the size of a given PCD token.\r
 \r
   @param[in]  TokenNumber The PCD token number to retrieve a current value for.\r
 \r
-  @return Returns the size of the token specified by TokenNumber. \r
+  @return Returns the size of the token specified by TokenNumber.\r
 \r
 **/\r
 UINTN\r
 EFIAPI\r
 LibPcdGetSize (\r
-  IN UINTN             TokenNumber\r
+  IN UINTN  TokenNumber\r
   )\r
 {\r
   ASSERT (FALSE);\r
@@ -184,13 +179,14 @@ LibPcdGetSize (
   return 0;\r
 }\r
 \r
-\r
-\r
 /**\r
+  This function provides a means by which to retrieve a value for a given PCD token.\r
+\r
   Returns the 8-bit value for the token specified by TokenNumber and Guid.\r
-  If Guid is NULL, then ASSERT(). \r
 \r
-  @param[in]  Guid Pointer to a 128-bit unique value that designates \r
+  If Guid is NULL, then ASSERT().\r
+\r
+  @param[in]  Guid The pointer to a 128-bit unique value that designates\r
               which namespace to retrieve a value from.\r
   @param[in]  TokenNumber The PCD token number to retrieve a current value for.\r
 \r
@@ -200,8 +196,8 @@ LibPcdGetSize (
 UINT8\r
 EFIAPI\r
 LibPcdGetEx8 (\r
-  IN CONST GUID        *Guid,\r
-  IN UINTN             TokenNumber\r
+  IN CONST GUID  *Guid,\r
+  IN UINTN       TokenNumber\r
   )\r
 {\r
   ASSERT (FALSE);\r
@@ -209,13 +205,14 @@ LibPcdGetEx8 (
   return 0;\r
 }\r
 \r
-\r
-\r
 /**\r
+  This function provides a means by which to retrieve a value for a given PCD token.\r
+\r
   Returns the 16-bit value for the token specified by TokenNumber and Guid.\r
-  If Guid is NULL, then ASSERT(). \r
 \r
-  @param[in]  Guid Pointer to a 128-bit unique value that designates \r
+  If Guid is NULL, then ASSERT().\r
+\r
+  @param[in]  Guid The pointer to a 128-bit unique value that designates\r
               which namespace to retrieve a value from.\r
   @param[in]  TokenNumber The PCD token number to retrieve a current value for.\r
 \r
@@ -225,8 +222,8 @@ LibPcdGetEx8 (
 UINT16\r
 EFIAPI\r
 LibPcdGetEx16 (\r
-  IN CONST GUID        *Guid,\r
-  IN UINTN             TokenNumber\r
+  IN CONST GUID  *Guid,\r
+  IN UINTN       TokenNumber\r
   )\r
 {\r
   ASSERT (FALSE);\r
@@ -234,13 +231,11 @@ LibPcdGetEx16 (
   return 0;\r
 }\r
 \r
-\r
-\r
 /**\r
   Returns the 32-bit value for the token specified by TokenNumber and Guid.\r
-  If Guid is NULL, then ASSERT(). \r
+  If Guid is NULL, then ASSERT().\r
 \r
-  @param[in]  Guid Pointer to a 128-bit unique value that designates \r
+  @param[in]  Guid The pointer to a 128-bit unique value that designates\r
               which namespace to retrieve a value from.\r
   @param[in]  TokenNumber The PCD token number to retrieve a current value for.\r
 \r
@@ -250,8 +245,8 @@ LibPcdGetEx16 (
 UINT32\r
 EFIAPI\r
 LibPcdGetEx32 (\r
-  IN CONST GUID        *Guid,\r
-  IN UINTN             TokenNumber\r
+  IN CONST GUID  *Guid,\r
+  IN UINTN       TokenNumber\r
   )\r
 {\r
   ASSERT (FALSE);\r
@@ -259,15 +254,16 @@ LibPcdGetEx32 (
   return 0;\r
 }\r
 \r
-\r
-\r
 /**\r
+  This function provides a means by which to retrieve a value for a given PCD token.\r
+\r
   Returns the 64-bit value for the token specified by TokenNumber and Guid.\r
-  If Guid is NULL, then ASSERT(). \r
 \r
-  @param[in]  Guid Pointer to a 128-bit unique value that designates \r
-              which namespace to retrieve a value from.\r
-  @param[in]  TokenNumber The PCD token number to retrieve a current value for.\r
+  If Guid is NULL, then ASSERT().\r
+\r
+  @param[in]  Guid          The pointer to a 128-bit unique value that designates\r
+                            which namespace to retrieve a value from.\r
+  @param[in]  TokenNumber   The PCD token number to retrieve a current value for.\r
 \r
   @return Return the UINT64.\r
 \r
@@ -275,8 +271,8 @@ LibPcdGetEx32 (
 UINT64\r
 EFIAPI\r
 LibPcdGetEx64 (\r
-  IN CONST GUID        *Guid,\r
-  IN UINTN             TokenNumber\r
+  IN CONST GUID  *Guid,\r
+  IN UINTN       TokenNumber\r
   )\r
 {\r
   ASSERT (FALSE);\r
@@ -284,15 +280,16 @@ LibPcdGetEx64 (
   return 0;\r
 }\r
 \r
+/**\r
+  This function provides a means by which to retrieve a value for a given PCD token.\r
 \r
+  Returns the pointer to the buffer of token specified by TokenNumber and Guid.\r
 \r
-/**\r
-  Returns the pointer to the buffer of the token specified by TokenNumber and Guid.\r
-  If Guid is NULL, then ASSERT(). \r
+  If Guid is NULL, then ASSERT().\r
 \r
-  @param[in]  Guid Pointer to a 128-bit unique value that designates \r
-              which namespace to retrieve a value from.\r
-  @param[in]  TokenNumber The PCD token number to retrieve a current value for.\r
+  @param[in]  Guid          The pointer to a 128-bit unique value that designates\r
+                            which namespace to retrieve a value from.\r
+  @param[in]  TokenNumber   The PCD token number to retrieve a current value for.\r
 \r
   @return Return the VOID* pointer.\r
 \r
@@ -300,8 +297,8 @@ LibPcdGetEx64 (
 VOID *\r
 EFIAPI\r
 LibPcdGetExPtr (\r
-  IN CONST GUID        *Guid,\r
-  IN UINTN             TokenNumber\r
+  IN CONST GUID  *Guid,\r
+  IN UINTN       TokenNumber\r
   )\r
 {\r
   ASSERT (FALSE);\r
@@ -309,15 +306,16 @@ LibPcdGetExPtr (
   return 0;\r
 }\r
 \r
+/**\r
+  This function provides a means by which to retrieve a value for a given PCD token.\r
 \r
+  Returns the Boolean value of the token specified by TokenNumber and Guid.\r
 \r
-/**\r
-  Returns the Boolean value of the token specified by TokenNumber and Guid. \r
-  If Guid is NULL, then ASSERT(). \r
+  If Guid is NULL, then ASSERT().\r
 \r
-  @param[in]  Guid Pointer to a 128-bit unique value that designates \r
-              which namespace to retrieve a value from.\r
-  @param[in]  TokenNumber The PCD token number to retrieve a current value for.\r
+  @param[in]  Guid          The pointer to a 128-bit unique value that designates\r
+                            which namespace to retrieve a value from.\r
+  @param[in]  TokenNumber   The PCD token number to retrieve a current value for.\r
 \r
   @return Return the BOOLEAN.\r
 \r
@@ -325,8 +323,8 @@ LibPcdGetExPtr (
 BOOLEAN\r
 EFIAPI\r
 LibPcdGetExBool (\r
-  IN CONST GUID        *Guid,\r
-  IN UINTN             TokenNumber\r
+  IN CONST GUID  *Guid,\r
+  IN UINTN       TokenNumber\r
   )\r
 {\r
   ASSERT (FALSE);\r
@@ -334,15 +332,16 @@ LibPcdGetExBool (
   return 0;\r
 }\r
 \r
+/**\r
+  This function provides a means by which to retrieve the size of a given PCD token.\r
 \r
+  Returns the size of the token specified by TokenNumber and Guid.\r
 \r
-/**\r
-  Returns the size of the token specified by TokenNumber and Guid. \r
-  If Guid is NULL, then ASSERT(). \r
+  If Guid is NULL, then ASSERT().\r
 \r
-  @param[in]  Guid Pointer to a 128-bit unique value that designates \r
-              which namespace to retrieve a value from.\r
-  @param[in]  TokenNumber The PCD token number to retrieve a current value for.\r
+  @param[in]  Guid          The pointer to a 128-bit unique value that designates\r
+                            which namespace to retrieve a value from.\r
+  @param[in]  TokenNumber   The PCD token number to retrieve a current value for.\r
 \r
   @return Return the size.\r
 \r
@@ -350,8 +349,8 @@ LibPcdGetExBool (
 UINTN\r
 EFIAPI\r
 LibPcdGetExSize (\r
-  IN CONST GUID        *Guid,\r
-  IN UINTN             TokenNumber\r
+  IN CONST GUID  *Guid,\r
+  IN UINTN       TokenNumber\r
   )\r
 {\r
   ASSERT (FALSE);\r
@@ -359,408 +358,419 @@ LibPcdGetExSize (
   return 0;\r
 }\r
 \r
+/**\r
+  This function provides a means by which to set a value for a given PCD token.\r
 \r
+  Sets the 8-bit value for the token specified by TokenNumber\r
+  to the value specified by Value.\r
 \r
-/**\r
-  Sets the 8-bit value for the token specified by TokenNumber \r
-  to the value specified by Value.  Value is returned.\r
-  \r
-  @param[in]  TokenNumber The PCD token number to set a current value for.\r
-  @param[in]  Value The 8-bit value to set.\r
+  @param[in] TokenNumber    The PCD token number to set a current value for.\r
+  @param[in] Value          The 8-bit value to set.\r
 \r
-  @return Return the value been set.\r
+  @return The status of the set operation.\r
 \r
 **/\r
-UINT8\r
+RETURN_STATUS\r
 EFIAPI\r
-LibPcdSet8 (\r
-  IN UINTN             TokenNumber,\r
-  IN UINT8             Value\r
+LibPcdSet8S (\r
+  IN UINTN  TokenNumber,\r
+  IN UINT8  Value\r
   )\r
 {\r
   ASSERT (FALSE);\r
 \r
-  return 0;\r
+  return RETURN_INVALID_PARAMETER;\r
 }\r
 \r
+/**\r
+  This function provides a means by which to set a value for a given PCD token.\r
 \r
+  Sets the 16-bit value for the token specified by TokenNumber\r
+  to the value specified by Value.\r
 \r
-/**\r
-  Sets the 16-bit value for the token specified by TokenNumber \r
-  to the value specified by Value.  Value is returned.\r
-  \r
-  @param[in]  TokenNumber The PCD token number to set a current value for.\r
-  @param[in]  Value The 16-bit value to set.\r
+  @param[in] TokenNumber    The PCD token number to set a current value for.\r
+  @param[in] Value          The 16-bit value to set.\r
 \r
-  @return Return the value been set.\r
+  @return The status of the set operation.\r
 \r
 **/\r
-UINT16\r
+RETURN_STATUS\r
 EFIAPI\r
-LibPcdSet16 (\r
-  IN UINTN             TokenNumber,\r
-  IN UINT16            Value\r
+LibPcdSet16S (\r
+  IN UINTN   TokenNumber,\r
+  IN UINT16  Value\r
   )\r
 {\r
   ASSERT (FALSE);\r
 \r
-  return 0;\r
+  return RETURN_INVALID_PARAMETER;\r
 }\r
 \r
+/**\r
+  This function provides a means by which to set a value for a given PCD token.\r
 \r
+  Sets the 32-bit value for the token specified by TokenNumber\r
+  to the value specified by Value.\r
 \r
-/**\r
-  Sets the 32-bit value for the token specified by TokenNumber \r
-  to the value specified by Value.  Value is returned.\r
-  \r
-  @param[in]  TokenNumber The PCD token number to set a current value for.\r
-  @param[in]  Value The 32-bit value to set.\r
+  @param[in] TokenNumber    The PCD token number to set a current value for.\r
+  @param[in] Value          The 32-bit value to set.\r
 \r
-  @return Return the value been set.\r
+  @return The status of the set operation.\r
 \r
 **/\r
-UINT32\r
+RETURN_STATUS\r
 EFIAPI\r
-LibPcdSet32 (\r
-  IN UINTN              TokenNumber,\r
-  IN UINT32             Value\r
+LibPcdSet32S (\r
+  IN UINTN   TokenNumber,\r
+  IN UINT32  Value\r
   )\r
 {\r
   ASSERT (FALSE);\r
 \r
-  return 0;\r
+  return RETURN_INVALID_PARAMETER;\r
 }\r
 \r
+/**\r
+  This function provides a means by which to set a value for a given PCD token.\r
 \r
+  Sets the 64-bit value for the token specified by TokenNumber\r
+  to the value specified by Value.\r
 \r
-/**\r
-  Sets the 64-bit value for the token specified by TokenNumber \r
-  to the value specified by Value.  Value is returned.\r
-  \r
-  @param[in]  TokenNumber The PCD token number to set a current value for.\r
-  @param[in]  Value The 64-bit value to set.\r
+  @param[in] TokenNumber    The PCD token number to set a current value for.\r
+  @param[in] Value          The 64-bit value to set.\r
 \r
-  @return Return the value been set.\r
+  @return The status of the set operation.\r
 \r
 **/\r
-UINT64\r
+RETURN_STATUS\r
 EFIAPI\r
-LibPcdSet64 (\r
-  IN UINTN              TokenNumber,\r
-  IN UINT64             Value\r
+LibPcdSet64S (\r
+  IN UINTN   TokenNumber,\r
+  IN UINT64  Value\r
   )\r
 {\r
   ASSERT (FALSE);\r
 \r
-  return 0;\r
+  return RETURN_INVALID_PARAMETER;\r
 }\r
 \r
+/**\r
+  This function provides a means by which to set a value for a given PCD token.\r
+\r
+  Sets a buffer for the token specified by TokenNumber to the value specified\r
+  by Buffer and SizeOfBuffer. If SizeOfBuffer is greater than the maximum size\r
+  support by TokenNumber, then set SizeOfBuffer to the maximum size supported by\r
+  TokenNumber and return EFI_INVALID_PARAMETER to indicate that the set operation\r
+  was not actually performed.\r
 \r
+  If SizeOfBuffer is set to MAX_ADDRESS, then SizeOfBuffer must be set to the\r
+  maximum size supported by TokenName and EFI_INVALID_PARAMETER must be returned.\r
 \r
-/**\r
-  Sets a buffer for the token specified by TokenNumber to \r
-  the value specified by Buffer and SizeOfValue.  Buffer to\r
-  be set is returned. The content of the buffer could be \r
-  overwritten if a Callback on SET is registered with this\r
-  TokenNumber.\r
-  \r
-  If SizeOfValue is greater than the maximum \r
-  size support by TokenNumber, then set SizeOfValue to the \r
-  maximum size supported by TokenNumber and return NULL to \r
-  indicate that the set operation was not actually performed. \r
-  \r
-  If SizeOfValue > 0 and Buffer is NULL, then ASSERT().\r
-  \r
-  @param[in]        TokenNumber     The PCD token number to set a current value for.\r
-  @param[in, out]   SizeOfBuffer    The size, in bytes, of Buffer.\r
-  @param[in]        Buffer          A pointer to the buffer to set.\r
+  If SizeOfBuffer is NULL, then ASSERT().\r
+  If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().\r
 \r
-  @return Return the pointer for the buffer been set.\r
+  @param[in]      TokenNumber   The PCD token number to set a current value for.\r
+  @param[in, out] SizeOfBuffer  The size, in bytes, of Buffer.\r
+  @param[in]      Buffer        A pointer to the buffer to set.\r
+\r
+  @return The status of the set operation.\r
 \r
 **/\r
-VOID *\r
+RETURN_STATUS\r
 EFIAPI\r
-LibPcdSetPtr (\r
-  IN      UINTN             TokenNumber,\r
-  IN OUT  UINTN             *SizeOfBuffer,\r
-  IN      VOID              *Buffer\r
+LibPcdSetPtrS (\r
+  IN       UINTN  TokenNumber,\r
+  IN OUT   UINTN  *SizeOfBuffer,\r
+  IN CONST VOID   *Buffer\r
   )\r
 {\r
   ASSERT (FALSE);\r
 \r
-  return NULL;\r
+  return RETURN_INVALID_PARAMETER;\r
 }\r
 \r
+/**\r
+  This function provides a means by which to set a value for a given PCD token.\r
 \r
+  Sets the boolean value for the token specified by TokenNumber\r
+  to the value specified by Value.\r
 \r
-/**\r
-  Sets the Boolean value for the token specified by TokenNumber \r
-  to the value specified by Value.  Value is returned.\r
-  \r
-  @param[in]  TokenNumber The PCD token number to set a current value for.\r
-  @param[in]  Value The boolean value to set.\r
+  @param[in] TokenNumber    The PCD token number to set a current value for.\r
+  @param[in] Value          The boolean value to set.\r
 \r
-  @return Return the value been set.\r
+  @return The status of the set operation.\r
 \r
 **/\r
-BOOLEAN\r
+RETURN_STATUS\r
 EFIAPI\r
-LibPcdSetBool (\r
-  IN UINTN             TokenNumber,\r
-  IN BOOLEAN           Value\r
+LibPcdSetBoolS (\r
+  IN UINTN    TokenNumber,\r
+  IN BOOLEAN  Value\r
   )\r
 {\r
   ASSERT (FALSE);\r
 \r
-  return FALSE;\r
+  return RETURN_INVALID_PARAMETER;\r
 }\r
 \r
+/**\r
+  This function provides a means by which to set a value for a given PCD token.\r
 \r
+  Sets the 8-bit value for the token specified by TokenNumber\r
+  to the value specified by Value.\r
 \r
-/**\r
-  Sets the 8-bit value for the token specified by TokenNumber and \r
-  Guid to the value specified by Value. Value is returned.\r
   If Guid is NULL, then ASSERT().\r
-  \r
-  @param[in]  Guid Pointer to a 128-bit unique value that \r
-              designates which namespace to set a value from.\r
-  @param[in]  TokenNumber The PCD token number to set a current value for.\r
-  @param[in]  Value The 8-bit value to set.\r
 \r
-  @return Return the value been set.\r
+  @param[in] Guid           The pointer to a 128-bit unique value that\r
+                            designates which namespace to set a value from.\r
+  @param[in] TokenNumber    The PCD token number to set a current value for.\r
+  @param[in] Value          The 8-bit value to set.\r
+\r
+  @return The status of the set operation.\r
 \r
 **/\r
-UINT8\r
+RETURN_STATUS\r
 EFIAPI\r
-LibPcdSetEx8 (\r
-  IN CONST GUID        *Guid,\r
-  IN UINTN             TokenNumber,\r
-  IN UINT8             Value\r
+LibPcdSetEx8S (\r
+  IN CONST GUID  *Guid,\r
+  IN UINTN       TokenNumber,\r
+  IN UINT8       Value\r
   )\r
 {\r
   ASSERT (FALSE);\r
 \r
-  return 0;\r
+  return RETURN_INVALID_PARAMETER;\r
 }\r
 \r
+/**\r
+  This function provides a means by which to set a value for a given PCD token.\r
 \r
+  Sets the 16-bit value for the token specified by TokenNumber\r
+  to the value specified by Value.\r
 \r
-/**\r
-  Sets the 16-bit value for the token specified by TokenNumber and \r
-  Guid to the value specified by Value. Value is returned.\r
   If Guid is NULL, then ASSERT().\r
-  \r
-  @param[in]  Guid Pointer to a 128-bit unique value that \r
-              designates which namespace to set a value from.\r
-  @param[in]  TokenNumber The PCD token number to set a current value for.\r
-  @param[in]  Value The 16-bit value to set.\r
 \r
-  @return Return the value been set.\r
+  @param[in] Guid           The pointer to a 128-bit unique value that\r
+                            designates which namespace to set a value from.\r
+  @param[in] TokenNumber    The PCD token number to set a current value for.\r
+  @param[in] Value          The 16-bit value to set.\r
+\r
+  @return The status of the set operation.\r
 \r
 **/\r
-UINT16\r
+RETURN_STATUS\r
 EFIAPI\r
-LibPcdSetEx16 (\r
-  IN CONST GUID        *Guid,\r
-  IN UINTN             TokenNumber,\r
-  IN UINT16            Value\r
+LibPcdSetEx16S (\r
+  IN CONST GUID  *Guid,\r
+  IN UINTN       TokenNumber,\r
+  IN UINT16      Value\r
   )\r
 {\r
   ASSERT (FALSE);\r
 \r
-  return 0;\r
+  return RETURN_INVALID_PARAMETER;\r
 }\r
 \r
+/**\r
+  This function provides a means by which to set a value for a given PCD token.\r
 \r
+  Sets the 32-bit value for the token specified by TokenNumber\r
+  to the value specified by Value.\r
 \r
-/**\r
-  Sets the 32-bit value for the token specified by TokenNumber and \r
-  Guid to the value specified by Value. Value is returned.\r
   If Guid is NULL, then ASSERT().\r
-  \r
-  @param[in]  Guid Pointer to a 128-bit unique value that \r
-              designates which namespace to set a value from.\r
-  @param[in]  TokenNumber The PCD token number to set a current value for.\r
-  @param[in]  Value The 32-bit value to set.\r
 \r
-  @return Return the value been set.\r
+  @param[in] Guid           The pointer to a 128-bit unique value that\r
+                            designates which namespace to set a value from.\r
+  @param[in] TokenNumber    The PCD token number to set a current value for.\r
+  @param[in] Value          The 32-bit value to set.\r
+\r
+  @return The status of the set operation.\r
 \r
 **/\r
-UINT32\r
+RETURN_STATUS\r
 EFIAPI\r
-LibPcdSetEx32 (\r
-  IN CONST GUID        *Guid,\r
-  IN UINTN             TokenNumber,\r
-  IN UINT32            Value\r
+LibPcdSetEx32S (\r
+  IN CONST GUID  *Guid,\r
+  IN UINTN       TokenNumber,\r
+  IN UINT32      Value\r
   )\r
 {\r
   ASSERT (FALSE);\r
 \r
-  return 0;\r
+  return RETURN_INVALID_PARAMETER;\r
 }\r
 \r
+/**\r
+  This function provides a means by which to set a value for a given PCD token.\r
 \r
+  Sets the 64-bit value for the token specified by TokenNumber\r
+  to the value specified by Value.\r
 \r
-/**\r
-  Sets the 64-bit value for the token specified by TokenNumber and \r
-  Guid to the value specified by Value. Value is returned.\r
   If Guid is NULL, then ASSERT().\r
-  \r
-  @param[in]  Guid Pointer to a 128-bit unique value that \r
-              designates which namespace to set a value from.\r
-  @param[in]  TokenNumber The PCD token number to set a current value for.\r
-  @param[in]  Value The 64-bit value to set.\r
 \r
-  @return Return the value been set.\r
+  @param[in] Guid           The pointer to a 128-bit unique value that\r
+                            designates which namespace to set a value from.\r
+  @param[in] TokenNumber    The PCD token number to set a current value for.\r
+  @param[in] Value          The 64-bit value to set.\r
+\r
+  @return The status of the set operation.\r
 \r
 **/\r
-UINT64\r
+RETURN_STATUS\r
 EFIAPI\r
-LibPcdSetEx64 (\r
-  IN CONST GUID        *Guid,\r
-  IN UINTN             TokenNumber,\r
-  IN UINT64            Value\r
+LibPcdSetEx64S (\r
+  IN CONST GUID  *Guid,\r
+  IN UINTN       TokenNumber,\r
+  IN UINT64      Value\r
   )\r
 {\r
   ASSERT (FALSE);\r
 \r
-  return 0;\r
+  return RETURN_INVALID_PARAMETER;\r
 }\r
 \r
+/**\r
+  This function provides a means by which to set a value for a given PCD token.\r
 \r
+  Sets a buffer for the token specified by TokenNumber to the value specified by\r
+  Buffer and SizeOfBuffer. If SizeOfBuffer is greater than the maximum size\r
+  support by TokenNumber, then set SizeOfBuffer to the maximum size supported by\r
+  TokenNumber and return EFI_INVALID_PARAMETER to indicate that the set operation\r
+  was not actually performed.\r
 \r
-/**\r
-  Sets a buffer for the token specified by TokenNumber to the value specified by \r
-  Buffer and SizeOfValue.  Buffer is returned.  If SizeOfValue is greater than \r
-  the maximum size support by TokenNumber, then set SizeOfValue to the maximum size \r
-  supported by TokenNumber and return NULL to indicate that the set operation \r
-  was not actually performed. \r
-  \r
-  If SizeOfValue > 0 and Buffer is NULL, then ASSERT().\r
-  \r
-  @param[in]  Guid Pointer to a 128-bit unique value that \r
-              designates which namespace to set a value from.\r
-  @param[in]  TokenNumber The PCD token number to set a current value for.\r
-  @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.\r
-  @param[in]  Buffer A pointer to the buffer to set.\r
+  If Guid is NULL, then ASSERT().\r
+  If SizeOfBuffer is NULL, then ASSERT().\r
+  If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().\r
+\r
+  @param[in]      Guid          Pointer to a 128-bit unique value that\r
+                                designates which namespace to set a value from.\r
+  @param[in]      TokenNumber   The PCD token number to set a current value for.\r
+  @param[in, out] SizeOfBuffer  The size, in bytes, of Buffer.\r
+  @param[in]      Buffer        A pointer to the buffer to set.\r
 \r
-  @return Return the pinter to the buffer been set.\r
+  @return The status of the set operation.\r
 \r
 **/\r
-VOID *\r
+RETURN_STATUS\r
 EFIAPI\r
-LibPcdSetExPtr (\r
-  IN      CONST GUID        *Guid,\r
-  IN      UINTN             TokenNumber,\r
-  IN OUT  UINTN             *SizeOfBuffer,\r
-  IN      VOID              *Buffer\r
+LibPcdSetExPtrS (\r
+  IN CONST GUID   *Guid,\r
+  IN       UINTN  TokenNumber,\r
+  IN OUT   UINTN  *SizeOfBuffer,\r
+  IN       VOID   *Buffer\r
   )\r
 {\r
   ASSERT (FALSE);\r
 \r
-  return NULL;\r
+  return RETURN_INVALID_PARAMETER;\r
 }\r
 \r
+/**\r
+  This function provides a means by which to set a value for a given PCD token.\r
 \r
+  Sets the boolean value for the token specified by TokenNumber\r
+  to the value specified by Value.\r
 \r
-/**\r
-  Sets the Boolean value for the token specified by TokenNumber and \r
-  Guid to the value specified by Value. Value is returned.\r
   If Guid is NULL, then ASSERT().\r
-  \r
-  @param[in]  Guid Pointer to a 128-bit unique value that \r
-              designates which namespace to set a value from.\r
-  @param[in]  TokenNumber The PCD token number to set a current value for.\r
-  @param[in]  Value The Boolean value to set.\r
 \r
-  @return Return the value been set.\r
+  @param[in] Guid           The pointer to a 128-bit unique value that\r
+                            designates which namespace to set a value from.\r
+  @param[in] TokenNumber    The PCD token number to set a current value for.\r
+  @param[in] Value          The boolean value to set.\r
+\r
+  @return The status of the set operation.\r
 \r
 **/\r
-BOOLEAN\r
+RETURN_STATUS\r
 EFIAPI\r
-LibPcdSetExBool (\r
-  IN CONST GUID        *Guid,\r
-  IN UINTN             TokenNumber,\r
-  IN BOOLEAN           Value\r
+LibPcdSetExBoolS (\r
+  IN CONST GUID  *Guid,\r
+  IN UINTN       TokenNumber,\r
+  IN BOOLEAN     Value\r
   )\r
 {\r
   ASSERT (FALSE);\r
 \r
-  return FALSE;\r
+  return RETURN_INVALID_PARAMETER;\r
 }\r
 \r
+/**\r
+  Set up a notification function that is called when a specified token is set.\r
 \r
+  When the token specified by TokenNumber and Guid is set,\r
+  then notification function specified by NotificationFunction is called.\r
+  If Guid is NULL, then the default token space is used.\r
 \r
-/**\r
-  When the token specified by TokenNumber and Guid is set, \r
-  then notification function specified by NotificationFunction is called.  \r
-  If Guid is NULL, then the default token space is used. \r
   If NotificationFunction is NULL, then ASSERT().\r
 \r
-  @param[in]  Guid Pointer to a 128-bit unique value that designates which \r
-              namespace to set a value from.  If NULL, then the default \r
-              token space is used.\r
-  @param[in]  TokenNumber The PCD token number to monitor.\r
-  @param[in]  NotificationFunction The function to call when the token \r
-              specified by Guid and TokenNumber is set.\r
+  @param[in]  Guid      The pointer to a 128-bit unique value that designates which\r
+                        namespace to set a value from.  If NULL, then the default\r
+                        token space is used.\r
+  @param[in]  TokenNumber   The PCD token number to monitor.\r
+  @param[in]  NotificationFunction  The function to call when the token\r
+                                    specified by Guid and TokenNumber is set.\r
 \r
 **/\r
 VOID\r
 EFIAPI\r
 LibPcdCallbackOnSet (\r
-  IN CONST GUID               *Guid,       OPTIONAL\r
-  IN UINTN                    TokenNumber,\r
-  IN PCD_CALLBACK             NotificationFunction\r
+  IN CONST GUID    *Guid        OPTIONAL,\r
+  IN UINTN         TokenNumber,\r
+  IN PCD_CALLBACK  NotificationFunction\r
   )\r
 {\r
   ASSERT (FALSE);\r
 }\r
 \r
-\r
-\r
 /**\r
   Disable a notification function that was established with LibPcdCallbackonSet().\r
+\r
+  Disable a notification function that was previously established with LibPcdCallbackOnSet().\r
+\r
   If NotificationFunction is NULL, then ASSERT().\r
+  If LibPcdCallbackOnSet() was not previously called with Guid, TokenNumber,\r
+  and NotificationFunction, then ASSERT().\r
 \r
-  @param[in]  Guid Specify the GUID token space.\r
-  @param[in]  TokenNumber Specify the token number.\r
+  @param[in]  Guid          Specify the GUID token space.\r
+  @param[in]  TokenNumber   Specify the token number.\r
   @param[in]  NotificationFunction The callback function to be unregistered.\r
 \r
 **/\r
 VOID\r
 EFIAPI\r
 LibPcdCancelCallback (\r
-  IN CONST GUID               *Guid,       OPTIONAL\r
-  IN UINTN                    TokenNumber,\r
-  IN PCD_CALLBACK             NotificationFunction\r
+  IN CONST GUID    *Guid        OPTIONAL,\r
+  IN UINTN         TokenNumber,\r
+  IN PCD_CALLBACK  NotificationFunction\r
   )\r
 {\r
   ASSERT (FALSE);\r
 }\r
 \r
+/**\r
+  Retrieves the next token in a token space.\r
 \r
+  Retrieves the next PCD token number from the token space specified by Guid.\r
+  If Guid is NULL, then the default token space is used.  If TokenNumber is 0,\r
+  then the first token number is returned.  Otherwise, the token number that\r
+  follows TokenNumber in the token space is returned.  If TokenNumber is the last\r
+  token number in the token space, then 0 is returned.\r
 \r
-/**\r
-  Retrieves the next PCD token number from the token space specified by Guid.  \r
-  If Guid is NULL, then the default token space is used.  If TokenNumber is 0, \r
-  then the first token number is returned.  Otherwise, the token number that \r
-  follows TokenNumber in the token space is returned.  If TokenNumber is the last \r
-  token number in the token space, then 0 is returned.  If TokenNumber is not 0 and \r
-  is not in the token space specified by Guid, then ASSERT().\r
+  If TokenNumber is not 0 and is not in the token space specified by Guid, then ASSERT().\r
 \r
-  @param[in]  Guid          Pointer to a 128-bit unique value that designates which namespace \r
-                            to set a value from.  If NULL, then the default token space is used.\r
-  @param[in]  TokenNumber   The previous PCD token number.  If 0, then retrieves the first PCD \r
-                            token number.\r
+  @param[in]  Guid        The pointer to a 128-bit unique value that designates which namespace\r
+                          to set a value from.  If NULL, then the default token space is used.\r
+  @param[in]  TokenNumber The previous PCD token number.  If 0, then retrieves the first PCD\r
+                          token number.\r
 \r
   @return The next valid token number.\r
 \r
 **/\r
-UINTN           \r
+UINTN\r
 EFIAPI\r
 LibPcdGetNextToken (\r
-  IN CONST GUID               *Guid, OPTIONAL\r
-  IN       UINTN              TokenNumber\r
+  IN CONST GUID  *Guid        OPTIONAL,\r
+  IN UINTN       TokenNumber\r
   )\r
 {\r
   ASSERT (FALSE);\r
@@ -768,29 +778,23 @@ LibPcdGetNextToken (
   return 0;\r
 }\r
 \r
-\r
-\r
 /**\r
-  Retrieves the next PCD token space from a token space specified by Guid.\r
-  Guid of NULL is reserved to mark the default local token namespace on the current\r
-  platform. If Guid is NULL, then the GUID of the first non-local token space of the \r
-  current platform is returned. If Guid is the last non-local token space, \r
-  then NULL is returned. \r
-\r
-  If Guid is not NULL and is not a valid token space in the current platform, then ASSERT().\r
+  Used to retrieve the list of available PCD token space GUIDs.\r
 \r
+  Returns the PCD token space GUID that follows TokenSpaceGuid in the list of token spaces\r
+  in the platform.\r
+  If TokenSpaceGuid is NULL, then a pointer to the first PCD token spaces returned.\r
+  If TokenSpaceGuid is the last PCD token space GUID in the list, then NULL is returned.\r
 \r
-  \r
-  @param[in]  Guid  Pointer to a 128-bit unique value that designates from which namespace \r
-                    to start the search.\r
+  @param  TokenSpaceGuid  The pointer to a PCD token space GUID.\r
 \r
   @return The next valid token namespace.\r
 \r
 **/\r
-GUID *           \r
+GUID *\r
 EFIAPI\r
 LibPcdGetNextTokenSpace (\r
-  IN CONST GUID  *Guid\r
+  IN CONST GUID  *TokenSpaceGuid\r
   )\r
 {\r
   ASSERT (FALSE);\r
@@ -798,52 +802,280 @@ LibPcdGetNextTokenSpace (
   return NULL;\r
 }\r
 \r
+/**\r
+  Sets a value of a patchable PCD entry that is type pointer.\r
+\r
+  Sets the PCD entry specified by PatchVariable to the value specified by Buffer\r
+  and SizeOfBuffer.  Buffer is returned.  If SizeOfBuffer is greater than\r
+  MaximumDatumSize, then set SizeOfBuffer to MaximumDatumSize and return\r
+  NULL to indicate that the set operation was not actually performed.\r
+  If SizeOfBuffer is set to MAX_ADDRESS, then SizeOfBuffer must be set to\r
+  MaximumDatumSize and NULL must be returned.\r
+\r
+  If PatchVariable is NULL, then ASSERT().\r
+  If SizeOfBuffer is NULL, then ASSERT().\r
+  If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().\r
+\r
+  @param[out] PatchVariable     A pointer to the global variable in a module that is\r
+                                the target of the set operation.\r
+  @param[in] MaximumDatumSize   The maximum size allowed for the PCD entry specified by PatchVariable.\r
+  @param[in, out] SizeOfBuffer  A pointer to the size, in bytes, of Buffer.\r
+  @param[in] Buffer             A pointer to the buffer to used to set the target variable.\r
+\r
+  @return Return the pointer to the buffer that was set.\r
+\r
+**/\r
+VOID *\r
+EFIAPI\r
+LibPatchPcdSetPtr (\r
+  OUT       VOID   *PatchVariable,\r
+  IN        UINTN  MaximumDatumSize,\r
+  IN OUT    UINTN  *SizeOfBuffer,\r
+  IN CONST  VOID   *Buffer\r
+  )\r
+{\r
+  ASSERT (PatchVariable != NULL);\r
+  ASSERT (SizeOfBuffer  != NULL);\r
+\r
+  if (*SizeOfBuffer > 0) {\r
+    ASSERT (Buffer != NULL);\r
+  }\r
+\r
+  if ((*SizeOfBuffer > MaximumDatumSize) ||\r
+      (*SizeOfBuffer == MAX_ADDRESS))\r
+  {\r
+    *SizeOfBuffer = MaximumDatumSize;\r
+    return NULL;\r
+  }\r
+\r
+  CopyMem (PatchVariable, Buffer, *SizeOfBuffer);\r
+\r
+  return (VOID *)Buffer;\r
+}\r
+\r
+/**\r
+  Sets a value of a patchable PCD entry that is type pointer.\r
+\r
+  Sets the PCD entry specified by PatchVariable to the value specified\r
+  by Buffer and SizeOfBuffer. If SizeOfBuffer is greater than MaximumDatumSize,\r
+  then set SizeOfBuffer to MaximumDatumSize and return RETURN_INVALID_PARAMETER\r
+  to indicate that the set operation was not actually performed.\r
+  If SizeOfBuffer is set to MAX_ADDRESS, then SizeOfBuffer must be set to\r
+  MaximumDatumSize and RETURN_INVALID_PARAMETER must be returned.\r
 \r
+  If PatchVariable is NULL, then ASSERT().\r
+  If SizeOfBuffer is NULL, then ASSERT().\r
+  If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().\r
+\r
+  @param[out] PatchVariable     A pointer to the global variable in a module that is\r
+                                the target of the set operation.\r
+  @param[in] MaximumDatumSize   The maximum size allowed for the PCD entry specified by PatchVariable.\r
+  @param[in, out] SizeOfBuffer  A pointer to the size, in bytes, of Buffer.\r
+  @param[in] Buffer             A pointer to the buffer to used to set the target variable.\r
+\r
+  @return The status of the set operation.\r
+\r
+**/\r
+RETURN_STATUS\r
+EFIAPI\r
+LibPatchPcdSetPtrS (\r
+  OUT      VOID   *PatchVariable,\r
+  IN       UINTN  MaximumDatumSize,\r
+  IN OUT   UINTN  *SizeOfBuffer,\r
+  IN CONST VOID   *Buffer\r
+  )\r
+{\r
+  ASSERT (PatchVariable != NULL);\r
+  ASSERT (SizeOfBuffer  != NULL);\r
+\r
+  if (*SizeOfBuffer > 0) {\r
+    ASSERT (Buffer != NULL);\r
+  }\r
+\r
+  if ((*SizeOfBuffer > MaximumDatumSize) ||\r
+      (*SizeOfBuffer == MAX_ADDRESS))\r
+  {\r
+    *SizeOfBuffer = MaximumDatumSize;\r
+    return RETURN_INVALID_PARAMETER;\r
+  }\r
+\r
+  CopyMem (PatchVariable, Buffer, *SizeOfBuffer);\r
+\r
+  return RETURN_SUCCESS;\r
+}\r
 \r
 /**\r
-  Sets the PCD entry specified by PatchVariable to the value specified by Buffer \r
-  and SizeOfValue.  Buffer is returned.  If SizeOfValue is greater than \r
-  MaximumDatumSize, then set SizeOfValue to MaximumDatumSize and return \r
-  NULL to indicate that the set operation was not actually performed.  \r
-  If SizeOfValue is set to MAX_ADDRESS, then SizeOfValue must be set to \r
+  Sets a value and size of a patchable PCD entry that is type pointer.\r
+\r
+  Sets the PCD entry specified by PatchVariable to the value specified by Buffer\r
+  and SizeOfBuffer.  Buffer is returned.  If SizeOfBuffer is greater than\r
+  MaximumDatumSize, then set SizeOfBuffer to MaximumDatumSize and return\r
+  NULL to indicate that the set operation was not actually performed.\r
+  If SizeOfBuffer is set to MAX_ADDRESS, then SizeOfBuffer must be set to\r
   MaximumDatumSize and NULL must be returned.\r
-  \r
+\r
   If PatchVariable is NULL, then ASSERT().\r
-  If SizeOfValue is NULL, then ASSERT().\r
-  If SizeOfValue > 0 and Buffer is NULL, then ASSERT().\r
+  If SizeOfPatchVariable is NULL, then ASSERT().\r
+  If SizeOfBuffer is NULL, then ASSERT().\r
+  If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().\r
 \r
-  @param[in] PatchVariable      A pointer to the global variable in a module that is \r
+  @param[out] PatchVariable     A pointer to the global variable in a module that is\r
                                 the target of the set operation.\r
+  @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of PatchVariable.\r
   @param[in] MaximumDatumSize   The maximum size allowed for the PCD entry specified by PatchVariable.\r
   @param[in, out] SizeOfBuffer  A pointer to the size, in bytes, of Buffer.\r
   @param[in] Buffer             A pointer to the buffer to used to set the target variable.\r
-  @return Return the pinter to the buffer been set.\r
+\r
+  @return Return the pointer to the buffer been set.\r
 \r
 **/\r
 VOID *\r
 EFIAPI\r
-LibPatchPcdSetPtr (\r
-  IN        VOID        *PatchVariable,\r
-  IN        UINTN       MaximumDatumSize,\r
-  IN OUT    UINTN       *SizeOfBuffer,\r
-  IN CONST  VOID        *Buffer\r
+LibPatchPcdSetPtrAndSize (\r
+  OUT       VOID   *PatchVariable,\r
+  OUT       UINTN  *SizeOfPatchVariable,\r
+  IN        UINTN  MaximumDatumSize,\r
+  IN OUT    UINTN  *SizeOfBuffer,\r
+  IN CONST  VOID   *Buffer\r
   )\r
 {\r
   ASSERT (PatchVariable != NULL);\r
+  ASSERT (SizeOfPatchVariable != NULL);\r
   ASSERT (SizeOfBuffer  != NULL);\r
-  \r
+\r
   if (*SizeOfBuffer > 0) {\r
     ASSERT (Buffer != NULL);\r
   }\r
 \r
   if ((*SizeOfBuffer > MaximumDatumSize) ||\r
-      (*SizeOfBuffer == MAX_ADDRESS)) {\r
+      (*SizeOfBuffer == MAX_ADDRESS))\r
+  {\r
     *SizeOfBuffer = MaximumDatumSize;\r
     return NULL;\r
   }\r
-    \r
+\r
+  CopyMem (PatchVariable, Buffer, *SizeOfBuffer);\r
+  *SizeOfPatchVariable = *SizeOfBuffer;\r
+\r
+  return (VOID *)Buffer;\r
+}\r
+\r
+/**\r
+  Sets a value and size of a patchable PCD entry that is type pointer.\r
+\r
+  Sets the PCD entry specified by PatchVariable to the value specified\r
+  by Buffer and SizeOfBuffer. If SizeOfBuffer is greater than MaximumDatumSize,\r
+  then set SizeOfBuffer to MaximumDatumSize and return RETURN_INVALID_PARAMETER\r
+  to indicate that the set operation was not actually performed.\r
+  If SizeOfBuffer is set to MAX_ADDRESS, then SizeOfBuffer must be set to\r
+  MaximumDatumSize and RETURN_INVALID_PARAMETER must be returned.\r
+\r
+  If PatchVariable is NULL, then ASSERT().\r
+  If SizeOfPatchVariable is NULL, then ASSERT().\r
+  If SizeOfBuffer is NULL, then ASSERT().\r
+  If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().\r
+\r
+  @param[out] PatchVariable     A pointer to the global variable in a module that is\r
+                                the target of the set operation.\r
+  @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of PatchVariable.\r
+  @param[in] MaximumDatumSize   The maximum size allowed for the PCD entry specified by PatchVariable.\r
+  @param[in, out] SizeOfBuffer  A pointer to the size, in bytes, of Buffer.\r
+  @param[in] Buffer             A pointer to the buffer to used to set the target variable.\r
+\r
+  @return The status of the set operation.\r
+\r
+**/\r
+RETURN_STATUS\r
+EFIAPI\r
+LibPatchPcdSetPtrAndSizeS (\r
+  OUT      VOID   *PatchVariable,\r
+  OUT      UINTN  *SizeOfPatchVariable,\r
+  IN       UINTN  MaximumDatumSize,\r
+  IN OUT   UINTN  *SizeOfBuffer,\r
+  IN CONST VOID   *Buffer\r
+  )\r
+{\r
+  ASSERT (PatchVariable != NULL);\r
+  ASSERT (SizeOfPatchVariable != NULL);\r
+  ASSERT (SizeOfBuffer  != NULL);\r
+\r
+  if (*SizeOfBuffer > 0) {\r
+    ASSERT (Buffer != NULL);\r
+  }\r
+\r
+  if ((*SizeOfBuffer > MaximumDatumSize) ||\r
+      (*SizeOfBuffer == MAX_ADDRESS))\r
+  {\r
+    *SizeOfBuffer = MaximumDatumSize;\r
+    return RETURN_INVALID_PARAMETER;\r
+  }\r
+\r
   CopyMem (PatchVariable, Buffer, *SizeOfBuffer);\r
-  \r
-  return (VOID *) Buffer;\r
+  *SizeOfPatchVariable = *SizeOfBuffer;\r
+\r
+  return RETURN_SUCCESS;\r
 }\r
 \r
+/**\r
+  Retrieve additional information associated with a PCD token.\r
+\r
+  This includes information such as the type of value the TokenNumber is associated with as well as possible\r
+  human readable name that is associated with the token.\r
+\r
+  If TokenNumber is not in the default token space specified, then ASSERT().\r
+\r
+  @param[in]    TokenNumber The PCD token number.\r
+  @param[out]   PcdInfo     The returned information associated with the requested TokenNumber.\r
+                            The caller is responsible for freeing the buffer that is allocated by callee for PcdInfo->PcdName.\r
+**/\r
+VOID\r
+EFIAPI\r
+LibPcdGetInfo (\r
+  IN        UINTN     TokenNumber,\r
+  OUT       PCD_INFO  *PcdInfo\r
+  )\r
+{\r
+  ASSERT (FALSE);\r
+}\r
+\r
+/**\r
+  Retrieve additional information associated with a PCD token.\r
+\r
+  This includes information such as the type of value the TokenNumber is associated with as well as possible\r
+  human readable name that is associated with the token.\r
+\r
+  If TokenNumber is not in the token space specified by Guid, then ASSERT().\r
+\r
+  @param[in]    Guid        The 128-bit unique value that designates the namespace from which to extract the value.\r
+  @param[in]    TokenNumber The PCD token number.\r
+  @param[out]   PcdInfo     The returned information associated with the requested TokenNumber.\r
+                            The caller is responsible for freeing the buffer that is allocated by callee for PcdInfo->PcdName.\r
+**/\r
+VOID\r
+EFIAPI\r
+LibPcdGetInfoEx (\r
+  IN CONST  GUID      *Guid,\r
+  IN        UINTN     TokenNumber,\r
+  OUT       PCD_INFO  *PcdInfo\r
+  )\r
+{\r
+  ASSERT (FALSE);\r
+}\r
+\r
+/**\r
+  Retrieve the currently set SKU Id.\r
+\r
+  @return   The currently set SKU Id. If the platform has not set at a SKU Id, then the\r
+            default SKU Id value of 0 is returned. If the platform has set a SKU Id, then the currently set SKU\r
+            Id is returned.\r
+**/\r
+UINTN\r
+EFIAPI\r
+LibPcdGetSku (\r
+  VOID\r
+  )\r
+{\r
+  ASSERT (FALSE);\r
+\r
+  return 0;\r
+}\r