Moved the MdePkg to OldMdePkg so that new code in MdePkg does not break existing builds. Also updated the SPD and FPD files UiNames

git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@2616 6f19259b-4bc3-4df7-8a09-765794883524

2 files changed, 0 insertions, 879 deletions

diff --git a/MdePkg/Library/BasePcdLibNull/BasePcdLibNull.msa b/MdePkg/Library/BasePcdLibNull/BasePcdLibNull.msa
deleted file mode 100644
index 4537f602c3..0000000000
--- a/MdePkg/Library/BasePcdLibNull/BasePcdLibNull.msa
+++ /dev/null
@@ -1,46 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>

-<ModuleSurfaceArea xmlns="http://www.TianoCore.org/2006/Edk2.0">

-  <MsaHeader>

-    <ModuleName>BasePcdLibNull</ModuleName>

-    <ModuleType>BASE</ModuleType>

-    <GuidValue>40096a3a-5c2a-4fbc-aef7-5475dd7ab334</GuidValue>

-    <Version>1.0</Version>

-    <Abstract>Component description file for NULL PCD Library</Abstract>

-    <Description>PCD Library that only provides access to Feature Flag, Fixed At Build,

-      and Binary Patch typed PCD entries.  Access to Dynamic PCD entries are ignored.</Description>

-    <Copyright>Copyright (c) 2006, Intel Corporation</Copyright>

-    <License>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

-      THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,

-      WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.</License>

-    <Specification>FRAMEWORK_BUILD_PACKAGING_SPECIFICATION   0x00000052</Specification>

-  </MsaHeader>

-  <ModuleDefinitions>

-    <SupportedArchitectures>IA32 X64 IPF EBC</SupportedArchitectures>

-    <BinaryModule>false</BinaryModule>

-    <OutputFileBasename>BasePcdLibNull</OutputFileBasename>

-  </ModuleDefinitions>

-  <LibraryClassDefinitions>

-    <LibraryClass Usage="ALWAYS_PRODUCED">

-      <Keyword>PcdLib</Keyword>

-    </LibraryClass>

-    <LibraryClass Usage="ALWAYS_CONSUMED">

-      <Keyword>DebugLib</Keyword>

-    </LibraryClass>

-    <LibraryClass Usage="ALWAYS_CONSUMED">

-      <Keyword>BaseMemoryLib</Keyword>

-    </LibraryClass>

-  </LibraryClassDefinitions>

-  <SourceFiles>

-    <Filename>PcdLib.c</Filename>

-  </SourceFiles>

-  <PackageDependencies>

-    <Package PackageGuid="5e0e9358-46b6-4ae2-8218-4ab8b9bbdcec"/>

-  </PackageDependencies>

-  <Externs>

-    <Specification>EFI_SPECIFICATION_VERSION 0x00020000</Specification>

-    <Specification>EDK_RELEASE_VERSION 0x00020000</Specification>

-  </Externs>

-</ModuleSurfaceArea>

diff --git a/MdePkg/Library/BasePcdLibNull/PcdLib.c b/MdePkg/Library/BasePcdLibNull/PcdLib.c
deleted file mode 100644
index ab6f711a00..0000000000
--- a/MdePkg/Library/BasePcdLibNull/PcdLib.c
+++ /dev/null
@@ -1,833 +0,0 @@
-/** @file

-  A emptry template implementation of PCD Library.

-

-  Copyright (c) 2006, 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

-

-  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,

-  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

-

-  Module Name:  PcdLib.c

-

-**/

-

-

-

-/**

-  Sets the current SKU in the PCD database to the value specified by SkuId.  SkuId is returned.

-

-  @param[in]  SkuId The SKU value that will be used when the PCD service will retrieve and 

-              set values associated with a PCD token.

-

-  @retval SKU_ID Return the SKU ID that just be set.

-

-**/

-UINTN           

-EFIAPI

-LibPcdSetSku (

-  IN UINTN  SkuId

-  )

-{

-  ASSERT (SkuId < 0x100);

-

-  return SkuId;

-}

-

-

-

-/**

-  Returns the 8-bit value for the token specified by TokenNumber. 

-

-  @param[in]  The PCD token number to retrieve a current value for.

-

-  @retval UINT8 Returns the 8-bit value for the token specified by TokenNumber. 

-

-**/

-UINT8

-EFIAPI

-LibPcdGet8 (

-  IN UINTN             TokenNumber

-  )

-{

-  return 0;

-}

-

-

-

-/**

-  Returns the 16-bit value for the token specified by TokenNumber. 

-

-  @param[in]  The PCD token number to retrieve a current value for.

-

-  @retval UINT16 Returns the 16-bit value for the token specified by TokenNumber. 

-

-**/

-UINT16

-EFIAPI

-LibPcdGet16 (

-  IN UINTN             TokenNumber

-  )

-{

-  return 0;

-}

-

-

-

-/**

-  Returns the 32-bit value for the token specified by TokenNumber. 

-

-  @param[in]  TokenNumber The PCD token number to retrieve a current value for.

-

-  @retval UINT32 Returns the 32-bit value for the token specified by TokenNumber.

-

-**/

-UINT32

-EFIAPI

-LibPcdGet32 (

-  IN UINTN             TokenNumber

-  )

-{

-  return 0;

-}

-

-

-

-/**

-  Returns the 64-bit value for the token specified by TokenNumber.

-

-  @param[in]  TokenNumber The PCD token number to retrieve a current value for.

-

-  @retval UINT64 Returns the 64-bit value for the token specified by TokenNumber.

-

-**/

-UINT64

-EFIAPI

-LibPcdGet64 (

-  IN UINTN             TokenNumber

-  )

-{

-  return 0;

-}

-

-

-

-/**

-  Returns the pointer to the buffer of the token specified by TokenNumber.

-

-  @param[in]  TokenNumber The PCD token number to retrieve a current value for.

-

-  @retval VOID* Returns the pointer to the token specified by TokenNumber.

-

-**/

-VOID *

-EFIAPI

-LibPcdGetPtr (

-  IN UINTN             TokenNumber

-  )

-{

-  return 0;

-}

-

-

-

-/**

-  Returns the Boolean value of the token specified by TokenNumber. 

-

-  @param[in]  TokenNumber The PCD token number to retrieve a current value for.

-

-  @retval BOOLEAN Returns the Boolean value of the token specified by TokenNumber. 

-

-**/

-BOOLEAN 

-EFIAPI

-LibPcdGetBool (

-  IN UINTN             TokenNumber

-  )

-{

-  return 0;

-}

-

-

-

-/**

-  Returns the size of the token specified by TokenNumber. 

-

-  @param[in]  TokenNumber The PCD token number to retrieve a current value for.

-

-  @retval UINTN Returns the size of the token specified by TokenNumber. 

-

-**/

-UINTN

-EFIAPI

-LibPcdGetSize (

-  IN UINTN             TokenNumber

-  )

-{

-  return 0;

-}

-

-

-

-/**

-  Returns the 8-bit value for the token specified by TokenNumber and Guid.

-  If Guid is NULL, then ASSERT(). 

-

-  @param[in]  Guid Pointer to a 128-bit unique value that designates 

-              which namespace to retrieve a value from.

-  @param[in]  TokenNumber The PCD token number to retrieve a current value for.

-

-  @retval UINT8 Return the UINT8.

-

-**/

-UINT8

-EFIAPI

-LibPcdGetEx8 (

-  IN CONST GUID        *Guid,

-  IN UINTN             TokenNumber

-  )

-{

-  ASSERT (Guid != NULL);

-

-  return 0;

-}

-

-

-

-/**

-  Returns the 16-bit value for the token specified by TokenNumber and Guid.

-  If Guid is NULL, then ASSERT(). 

-

-  @param[in]  Guid Pointer to a 128-bit unique value that designates 

-              which namespace to retrieve a value from.

-  @param[in]  TokenNumber The PCD token number to retrieve a current value for.

-

-  @retval UINT16 Return the UINT16.

-

-**/

-UINT16

-EFIAPI

-LibPcdGetEx16 (

-  IN CONST GUID        *Guid,

-  IN UINTN             TokenNumber

-  )

-{

-  ASSERT (Guid != NULL);

-

-  return 0;

-}

-

-

-

-/**

-  Returns the 32-bit value for the token specified by TokenNumber and Guid.

-  If Guid is NULL, then ASSERT(). 

-

-  @param[in]  Guid Pointer to a 128-bit unique value that designates 

-              which namespace to retrieve a value from.

-  @param[in]  TokenNumber The PCD token number to retrieve a current value for.

-

-  @retval UINT32 Return the UINT32.

-

-**/

-UINT32

-EFIAPI

-LibPcdGetEx32 (

-  IN CONST GUID        *Guid,

-  IN UINTN             TokenNumber

-  )

-{

-  ASSERT (Guid != NULL);

-

-  return 0;

-}

-

-

-

-/**

-  Returns the 64-bit value for the token specified by TokenNumber and Guid.

-  If Guid is NULL, then ASSERT(). 

-

-  @param[in]  Guid Pointer to a 128-bit unique value that designates 

-              which namespace to retrieve a value from.

-  @param[in]  TokenNumber The PCD token number to retrieve a current value for.

-

-  @retval UINT64 Return the UINT64.

-

-**/

-UINT64

-EFIAPI

-LibPcdGetEx64 (

-  IN CONST GUID        *Guid,

-  IN UINTN             TokenNumber

-  )

-{

-  ASSERT (Guid != NULL);

-

-  return 0;

-}

-

-

-

-/**

-  Returns the pointer to the buffer of the token specified by TokenNumber and Guid.

-  If Guid is NULL, then ASSERT(). 

-

-  @param[in]  Guid Pointer to a 128-bit unique value that designates 

-              which namespace to retrieve a value from.

-  @param[in]  TokenNumber The PCD token number to retrieve a current value for.

-

-  @retval VOID* Return the VOID* pointer.

-

-**/

-VOID *

-EFIAPI

-LibPcdGetExPtr (

-  IN CONST GUID        *Guid,

-  IN UINTN             TokenNumber

-  )

-{

-  ASSERT (Guid != NULL);

-

-  return 0;

-}

-

-

-

-/**

-  Returns the Boolean value of the token specified by TokenNumber and Guid. 

-  If Guid is NULL, then ASSERT(). 

-

-  @param[in]  Guid Pointer to a 128-bit unique value that designates 

-              which namespace to retrieve a value from.

-  @param[in]  TokenNumber The PCD token number to retrieve a current value for.

-

-  @retval BOOLEAN Return the BOOLEAN.

-

-**/

-BOOLEAN

-EFIAPI

-LibPcdGetExBool (

-  IN CONST GUID        *Guid,

-  IN UINTN             TokenNumber

-  )

-{

-  ASSERT (Guid != NULL);

-

-  return 0;

-}

-

-

-

-/**

-  Returns the size of the token specified by TokenNumber and Guid. 

-  If Guid is NULL, then ASSERT(). 

-

-  @param[in]  Guid Pointer to a 128-bit unique value that designates 

-              which namespace to retrieve a value from.

-  @param[in]  TokenNumber The PCD token number to retrieve a current value for.

-

-  @retval UINTN Return the size.

-

-**/

-UINTN

-EFIAPI

-LibPcdGetExSize (

-  IN CONST GUID        *Guid,

-  IN UINTN             TokenNumber

-  )

-{

-  ASSERT (Guid != NULL);

-

-  return 0;

-}

-

-

-

-/**

-  Sets the 8-bit value for the token specified by TokenNumber 

-  to the value specified by Value.  Value is returned.

-  

-  @param[in]  TokenNumber The PCD token number to set a current value for.

-  @param[in]  Value The 8-bit value to set.

-

-  @retval UINT8 Return the value been set.

-

-**/

-UINT8

-EFIAPI

-LibPcdSet8 (

-  IN UINTN             TokenNumber,

-  IN UINT8             Value

-  )

-{

-  return Value;

-}

-

-

-

-/**

-  Sets the 16-bit value for the token specified by TokenNumber 

-  to the value specified by Value.  Value is returned.

-  

-  @param[in]  TokenNumber The PCD token number to set a current value for.

-  @param[in]  Value The 16-bit value to set.

-

-  @retval UINT16 Return the value been set.

-

-**/

-UINT16

-EFIAPI

-LibPcdSet16 (

-  IN UINTN             TokenNumber,

-  IN UINT16            Value

-  )

-{

-  return Value;

-}

-

-

-

-/**

-  Sets the 32-bit value for the token specified by TokenNumber 

-  to the value specified by Value.  Value is returned.

-  

-  @param[in]  TokenNumber The PCD token number to set a current value for.

-  @param[in]  Value The 32-bit value to set.

-

-  @retval UINT32 Return the value been set.

-

-**/

-UINT32

-EFIAPI

-LibPcdSet32 (

-  IN UINTN              TokenNumber,

-  IN UINT32             Value

-  )

-{

-  return Value;

-}

-

-

-

-/**

-  Sets the 64-bit value for the token specified by TokenNumber 

-  to the value specified by Value.  Value is returned.

-  

-  @param[in]  TokenNumber The PCD token number to set a current value for.

-  @param[in]  Value The 64-bit value to set.

-

-  @retval UINT64 Return the value been set.

-

-**/

-UINT64

-EFIAPI

-LibPcdSet64 (

-  IN UINTN              TokenNumber,

-  IN UINT64             Value

-  )

-{

-  return Value;

-}

-

-

-

-/**

-  Sets a buffer for the token specified by TokenNumber to 

-  the value specified by Buffer and SizeOfValue.  Buffer to

-  be set is returned. The content of the buffer could be 

-  overwritten if a Callback on SET is registered with this

-  TokenNumber.

-  

-  If SizeOfValue is greater than the maximum 

-  size support by TokenNumber, then set SizeOfValue to the 

-  maximum size supported by TokenNumber and return NULL to 

-  indicate that the set operation was not actually performed. 

-  

-  If SizeOfValue > 0 and Buffer is NULL, then ASSERT().

-  

-  @param[in]  TokenNumber The PCD token number to set a current value for.

-  @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.

-  @param[in]  Value A pointer to the buffer to set.

-

-  @retval VOID* Return the pointer for the buffer been set.

-

-**/

-VOID *

-EFIAPI

-LibPcdSetPtr (

-  IN      UINTN             TokenNumber,

-  IN OUT  UINTN             *SizeOfBuffer,

-  IN      VOID              *Buffer

-  )

-{

-  ASSERT (SizeOfBuffer != NULL);

-

-  if (*SizeOfBuffer > 0) {

-    ASSERT (Buffer != NULL);

-  }

-

-  return Buffer;

-}

-

-

-

-/**

-  Sets the Boolean value for the token specified by TokenNumber 

-  to the value specified by Value.  Value is returned.

-  

-  @param[in]  TokenNumber The PCD token number to set a current value for.

-  @param[in]  Value The boolean value to set.

-

-  @retval BOOLEAN Return the value been set.

-

-**/

-BOOLEAN

-EFIAPI

-LibPcdSetBool (

-  IN UINTN             TokenNumber,

-  IN BOOLEAN           Value

-  )

-{

-  return Value;

-}

-

-

-

-/**

-  Sets the 8-bit value for the token specified by TokenNumber and 

-  Guid to the value specified by Value. Value is returned.

-  If Guid is NULL, then ASSERT().

-  

-  @param[in]  Guid Pointer to a 128-bit unique value that 

-              designates which namespace to set a value from.

-  @param[in]  TokenNumber The PCD token number to set a current value for.

-  @param[in]  Value The 8-bit value to set.

-

-  @retval UINT8 Return the value been set.

-

-**/

-UINT8

-EFIAPI

-LibPcdSetEx8 (

-  IN CONST GUID        *Guid,

-  IN UINTN             TokenNumber,

-  IN UINT8             Value

-  )

-{

-  ASSERT (Guid != NULL);

-

-  return Value;

-}

-

-

-

-/**

-  Sets the 16-bit value for the token specified by TokenNumber and 

-  Guid to the value specified by Value. Value is returned.

-  If Guid is NULL, then ASSERT().

-  

-  @param[in]  Guid Pointer to a 128-bit unique value that 

-              designates which namespace to set a value from.

-  @param[in]  TokenNumber The PCD token number to set a current value for.

-  @param[in]  Value The 16-bit value to set.

-

-  @retval UINT8 Return the value been set.

-

-**/

-UINT16

-EFIAPI

-LibPcdSetEx16 (

-  IN CONST GUID        *Guid,

-  IN UINTN             TokenNumber,

-  IN UINT16            Value

-  )

-{

-  ASSERT (Guid != NULL);

-

-  return Value;

-}

-

-

-

-/**

-  Sets the 32-bit value for the token specified by TokenNumber and 

-  Guid to the value specified by Value. Value is returned.

-  If Guid is NULL, then ASSERT().

-  

-  @param[in]  Guid Pointer to a 128-bit unique value that 

-              designates which namespace to set a value from.

-  @param[in]  TokenNumber The PCD token number to set a current value for.

-  @param[in]  Value The 32-bit value to set.

-

-  @retval UINT32 Return the value been set.

-

-**/

-UINT32

-EFIAPI

-LibPcdSetEx32 (

-  IN CONST GUID        *Guid,

-  IN UINTN             TokenNumber,

-  IN UINT32            Value

-  )

-{

-  ASSERT (Guid != NULL);

-

-  return Value;

-}

-

-

-

-/**

-  Sets the 64-bit value for the token specified by TokenNumber and 

-  Guid to the value specified by Value. Value is returned.

-  If Guid is NULL, then ASSERT().

-  

-  @param[in]  Guid Pointer to a 128-bit unique value that 

-              designates which namespace to set a value from.

-  @param[in]  TokenNumber The PCD token number to set a current value for.

-  @param[in]  Value The 64-bit value to set.

-

-  @retval UINT64 Return the value been set.

-

-**/

-UINT64

-EFIAPI

-LibPcdSetEx64 (

-  IN CONST GUID        *Guid,

-  IN UINTN             TokenNumber,

-  IN UINT64            Value

-  )

-{

-  ASSERT (Guid != NULL);

-

-  return Value;

-}

-

-

-

-/**

-  Sets a buffer for the token specified by TokenNumber to the value specified by 

-  Buffer and SizeOfValue.  Buffer is returned.  If SizeOfValue is greater than 

-  the maximum size support by TokenNumber, then set SizeOfValue to the maximum size 

-  supported by TokenNumber and return NULL to indicate that the set operation 

-  was not actually performed. 

-  

-  If SizeOfValue > 0 and Buffer is NULL, then ASSERT().

-  

-  @param[in]  Guid Pointer to a 128-bit unique value that 

-              designates which namespace to set a value from.

-  @param[in]  TokenNumber The PCD token number to set a current value for.

-  @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.

-  @param[in]  Buffer A pointer to the buffer to set.

-

-  @retval VOID * Return the pinter to the buffer been set.

-

-**/

-VOID *

-EFIAPI

-LibPcdSetExPtr (

-  IN      CONST GUID        *Guid,

-  IN      UINTN             TokenNumber,

-  IN OUT  UINTN             *SizeOfBuffer,

-  IN      VOID              *Buffer

-  )

-{

-  ASSERT (Guid != NULL);

-

-  ASSERT (SizeOfBuffer != NULL);

-  

-  if (*SizeOfBuffer > 0) {

-    ASSERT (Buffer != NULL);

-  }

-

-  return Buffer;

-}

-

-

-

-/**

-  Sets the Boolean value for the token specified by TokenNumber and 

-  Guid to the value specified by Value. Value is returned.

-  If Guid is NULL, then ASSERT().

-  

-  @param[in]  Guid Pointer to a 128-bit unique value that 

-              designates which namespace to set a value from.

-  @param[in]  TokenNumber The PCD token number to set a current value for.

-  @param[in]  Value The Boolean value to set.

-

-  @retval Boolean Return the value been set.

-

-**/

-BOOLEAN

-EFIAPI

-LibPcdSetExBool (

-  IN CONST GUID        *Guid,

-  IN UINTN             TokenNumber,

-  IN BOOLEAN           Value

-  )

-{

-  ASSERT (Guid != NULL);

-

-  return Value;

-}

-

-

-

-/**

-  When the token specified by TokenNumber and Guid is set, 

-  then notification function specified by NotificationFunction is called.  

-  If Guid is NULL, then the default token space is used. 

-  If NotificationFunction is NULL, then ASSERT().

-

-  @param[in]  Guid Pointer to a 128-bit unique value that designates which 

-              namespace to set a value from.  If NULL, then the default 

-              token space is used.

-  @param[in]  TokenNumber The PCD token number to monitor.

-  @param[in]  NotificationFunction The function to call when the token 

-              specified by Guid and TokenNumber is set.

-

-  @retval VOID

-

-**/

-VOID

-EFIAPI

-LibPcdCallbackOnSet (

-  IN CONST GUID               *Guid,       OPTIONAL

-  IN UINTN                    TokenNumber,

-  IN PCD_CALLBACK             NotificationFunction

-  )

-{

-  ASSERT (NotificationFunction != NULL);

-}

-

-

-

-/**

-  Disable a notification function that was established with LibPcdCallbackonSet().

-  If NotificationFunction is NULL, then ASSERT().

-

-  @param[in]  Guid Specify the GUID token space.

-  @param[in]  TokenNumber Specify the token number.

-  @param[in]  NotificationFunction The callback function to be unregistered.

-

-  @retval VOID

-

-**/

-VOID

-EFIAPI

-LibPcdCancelCallback (

-  IN CONST GUID               *Guid,       OPTIONAL

-  IN UINTN                    TokenNumber,

-  IN PCD_CALLBACK             NotificationFunction

-  )

-{

-  ASSERT (NotificationFunction != NULL);

-}

-

-

-

-/**

-  Retrieves the next PCD token number from the token space specified by Guid.  

-  If Guid is NULL, then the default token space is used.  If TokenNumber is 0, 

-  then the first token number is returned.  Otherwise, the token number that 

-  follows TokenNumber in the token space is returned.  If TokenNumber is the last 

-  token number in the token space, then 0 is returned.  If TokenNumber is not 0 and 

-  is not in the token space specified by Guid, then ASSERT().

-

-  @param[in]  Pointer to a 128-bit unique value that designates which namespace 

-              to set a value from.  If NULL, then the default token space is used.

-  @param[in]  The previous PCD token number.  If 0, then retrieves the first PCD 

-              token number.

-

-  @retval UINTN            The next valid token number.

-

-**/

-UINTN           

-EFIAPI

-LibPcdGetNextToken (

-  IN CONST GUID               *Guid, OPTIONAL

-  IN       UINTN              TokenNumber

-  )

-{

-  return 0;

-}

-

-

-

-/**

-  Retrieves the next PCD token space from a token space specified by Guid.

-  Guid of NULL is reserved to mark the default local token namespace on the current

-  platform. If Guid is NULL, then the GUID of the first non-local token space of the 

-  current platform is returned. If Guid is the last non-local token space, 

-  then NULL is returned. 

-

-  If Guid is not NULL and is not a valid token space in the current platform, then ASSERT().

-

-

-  

-  @param[in]  Pointer to a 128-bit unique value that designates from which namespace 

-              to start the search.

-

-  @retval CONST GUID *  The next valid token namespace.

-

-**/

-GUID *           

-EFIAPI

-LibPcdGetNextTokenSpace (

-  IN CONST GUID  *Guid

-  )

-{

-  return NULL;

-}

-

-

-

-/**

-  Sets the PCD entry specified by PatchVariable to the value specified by Buffer 

-  and SizeOfValue.  Buffer is returned.  If SizeOfValue is greater than 

-  MaximumDatumSize, then set SizeOfValue to MaximumDatumSize and return 

-  NULL to indicate that the set operation was not actually performed.  

-  If SizeOfValue is set to MAX_ADDRESS, then SizeOfValue must be set to 

-  MaximumDatumSize and NULL must be returned.

-  

-  If PatchVariable is NULL, then ASSERT().

-  If SizeOfValue is NULL, then ASSERT().

-  If SizeOfValue > 0 and Buffer is NULL, then ASSERT().

-

-  @param[in] PatchVariable      A pointer to the global variable in a module that is 

-                                the target of the set operation.

-  @param[in] MaximumDatumSize   The maximum size allowed for the PCD entry specified by PatchVariable.

-  @param[in, out] SizeOfBuffer  A pointer to the size, in bytes, of Buffer.

-  @param[in] Buffer             A pointer to the buffer to used to set the target variable.

-

-**/

-VOID *

-EFIAPI

-LibPatchPcdSetPtr (

-  IN        VOID        *PatchVariable,

-  IN        UINTN       MaximumDatumSize,

-  IN OUT    UINTN       *SizeOfBuffer,

-  IN CONST  VOID        *Buffer

-  )

-{

-  ASSERT (PatchVariable != NULL);

-  ASSERT (SizeOfBuffer  != NULL);

-  

-  if (*SizeOfBuffer > 0) {

-    ASSERT (Buffer != NULL);

-  }

-

-  if ((*SizeOfBuffer > MaximumDatumSize) ||

-      (*SizeOfBuffer == MAX_ADDRESS)) {

-    *SizeOfBuffer = MaximumDatumSize;

-    return NULL;

-  }

-    

-  CopyMem (PatchVariable, Buffer, *SizeOfBuffer);

-  

-  return (VOID *) Buffer;

-}

-