]> git.proxmox.com Git - mirror_edk2.git/blobdiff - MdePkg/Include/Library/PcdLib.h
MdePkg: Remove code wrapped by DISABLE_NEW_DEPRECATED_INTERFACES
[mirror_edk2.git] / MdePkg / Include / Library / PcdLib.h
index f09053e3cb86401219b6801ad9da0adee6cf5078..71738857ad198038d3d2657f6a8939b10538cb24 100644 (file)
@@ -481,106 +481,6 @@ SPDX-License-Identifier: BSD-2-Clause-Patent
 **/\r
 #define PcdGetExSize(Guid, TokenName) LibPcdGetExSize ((Guid), PcdTokenEx(Guid,TokenName))\r
 \r
-#ifndef DISABLE_NEW_DEPRECATED_INTERFACES\r
-/**\r
-  Sets an 8-bit PCD token value based on a token name.\r
-\r
-  Sets the 8-bit value for the token specified by TokenName. Value is returned.\r
-  If TokenName is not a valid token in the token space, then the module will not build.\r
-\r
-  @param   TokenName  The name of the PCD token to retrieve a current value for.\r
-  @param   Value      The 8-bit value to set.\r
-\r
-  @return Return the Value that was set.\r
-\r
-**/\r
-#define PcdSet8(TokenName, Value)           _PCD_SET_MODE_8_##TokenName     ((Value))\r
-\r
-\r
-/**\r
-  Sets a 16-bit PCD token value based on a token name.\r
-\r
-  Sets the 16-bit value for the token specified by TokenName. Value is returned.\r
-  If TokenName is not a valid token in the token space, then the module will not build.\r
-\r
-  @param   TokenName  The name of the PCD token to retrieve a current value for.\r
-  @param   Value      The 16-bit value to set.\r
-\r
-  @return Return the Value that was set.\r
-\r
-**/\r
-#define PcdSet16(TokenName, Value)          _PCD_SET_MODE_16_##TokenName    ((Value))\r
-\r
-\r
-/**\r
-  Sets a 32-bit PCD token value based on a token name.\r
-\r
-  Sets the 32-bit value for the token specified by TokenName. Value is returned.\r
-  If TokenName is not a valid token in the token space, then the module will not build.\r
-\r
-  @param   TokenName  The name of the PCD token to retrieve a current value for.\r
-  @param   Value      The 32-bit value to set.\r
-\r
-  @return Return the Value that was set.\r
-\r
-**/\r
-#define PcdSet32(TokenName, Value)          _PCD_SET_MODE_32_##TokenName    ((Value))\r
-\r
-\r
-/**\r
-  Sets a 64-bit PCD token value based on a token name.\r
-\r
-  Sets the 64-bit value for the token specified by TokenName. Value is returned.\r
-  If TokenName is not a valid token in the token space, then the module will not build.\r
-\r
-  @param   TokenName  The name of the PCD token to retrieve a current value for.\r
-  @param   Value      The 64-bit value to set.\r
-\r
-  @return Return the Value that was set.\r
-\r
-**/\r
-#define PcdSet64(TokenName, Value)          _PCD_SET_MODE_64_##TokenName    ((Value))\r
-\r
-\r
-/**\r
-  Sets a pointer to a PCD token buffer based on a token name.\r
-\r
-  Sets the buffer for the token specified by TokenName. Buffer is returned.\r
-  If SizeOfBuffer is greater than the maximum size supported by TokenName,\r
-  then set SizeOfBuffer to the maximum size supported by TokenName and return NULL\r
-  to indicate that the set operation was not actually performed.  If SizeOfBuffer\r
-  is set to MAX_ADDRESS, then SizeOfBuffer must be set to the maximum size supported\r
-  by TokenName and NULL must be returned.\r
-  If TokenName is not a valid token in the token space, then the module will not build.\r
-\r
-  If SizeOfBuffer is NULL, then ASSERT().\r
-  If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().\r
-\r
-  @param   TokenName      The name of the PCD token to set the current value for.\r
-  @param   SizeOfBuffer   A pointer to the size, in bytes, of Buffer.\r
-  @param   Buffer         A pointer to the buffer to set.\r
-\r
-  @return Return the pointer to the Buffer that was set.\r
-\r
-**/\r
-#define PcdSetPtr(TokenName, SizeOfBuffer, Buffer) \\r
-                                            _PCD_SET_MODE_PTR_##TokenName   ((SizeOfBuffer), (Buffer))\r
-\r
-/**\r
-  Sets a Boolean PCD token value based on a token name.\r
-\r
-  Sets the Boolean value for the token specified by TokenName. Value is returned.\r
-  If TokenName is not a valid token in the token space, then the module will not build.\r
-\r
-  @param   TokenName      The name of the PCD token to set the current value for.\r
-  @param   Buffer         The Boolean value to set.\r
-\r
-  @return Return the Value that was set.\r
-\r
-**/\r
-#define PcdSetBool(TokenName, Value)        _PCD_SET_MODE_BOOL_##TokenName  ((Value))\r
-#endif\r
-\r
 /**\r
   Sets a 8-bit PCD token value based on a token name.\r
 \r
@@ -806,137 +706,6 @@ SPDX-License-Identifier: BSD-2-Clause-Patent
 \r
 \r
 \r
-#ifndef DISABLE_NEW_DEPRECATED_INTERFACES\r
-/**\r
-  Sets an 8-bit PCD token value based on a GUID and a token name.\r
-\r
-  Sets the 8-bit value for the token specified by Guid and TokenName. Value is returned.\r
-  If TokenName is not a valid token in the token space specified by Guid,\r
-  then the module will not build.\r
-\r
-  If Guid is NULL, then ASSERT().\r
-\r
-  @param   Guid        Pointer to a 128-bit unique value that designates\r
-                       which namespace to retrieve a value from.\r
-  @param   TokenName   The name of the PCD token to set the current value for.\r
-  @param   Value       The 8-bit value to set.\r
-\r
-  @return Return the Value that was set.\r
-\r
-**/\r
-#define PcdSetEx8(Guid, TokenName, Value)   LibPcdSetEx8   ((Guid), PcdTokenEx(Guid,TokenName), (Value))\r
-\r
-\r
-/**\r
-  Sets a 16-bit PCD token value based on a GUID and a token name.\r
-\r
-  Sets the 16-bit value for the token specified by Guid and TokenName. Value is returned.\r
-  If TokenName is not a valid token in the token space specified by Guid,\r
-  then the module will not build.\r
-\r
-  If Guid is NULL, then ASSERT().\r
-\r
-  @param   Guid        Pointer to a 128-bit unique value that designates\r
-                       which namespace to retrieve a value from.\r
-  @param   TokenName   The name of the PCD token to set the current value for.\r
-  @param   Value       The 16-bit value to set.\r
-\r
-  @return Return the Value that was set.\r
-\r
-**/\r
-#define PcdSetEx16(Guid, TokenName, Value)  LibPcdSetEx16  ((Guid), PcdTokenEx(Guid,TokenName), (Value))\r
-\r
-\r
-/**\r
-  Sets a 32-bit PCD token value based on a GUID and a token name.\r
-\r
-  Sets the 32-bit value for the token specified by Guid and TokenName. Value is returned.\r
-  If TokenName is not a valid token in the token space specified by Guid,\r
-  then the module will not build.\r
-\r
-  If Guid is NULL, then ASSERT().\r
-\r
-  @param   Guid        Pointer to a 128-bit unique value that designates\r
-                       which namespace to retrieve a value from.\r
-  @param   TokenName   The name of the PCD token to set the current value for.\r
-  @param   Value       The 32-bit value to set.\r
-\r
-  @return Return the Value that was set.\r
-\r
-**/\r
-#define PcdSetEx32(Guid, TokenName, Value)  LibPcdSetEx32  ((Guid), PcdTokenEx(Guid,TokenName), (Value))\r
-\r
-\r
-/**\r
-  Sets a 64-bit PCD token value based on a GUID and a token name.\r
-\r
-  Sets the 64-bit value for the token specified by Guid and TokenName. Value is returned.\r
-  If TokenName is not a valid token in the token space specified by Guid,\r
-  then the module will not build.\r
-\r
-  If Guid is NULL, then ASSERT().\r
-\r
-  @param   Guid        Pointer to a 128-bit unique value that designates\r
-  which namespace to retrieve a value from.\r
-  @param   TokenName   The name of the PCD token to set the current value for.\r
-  @param   Value       The 64-bit value to set.\r
-\r
-  @return Return the Value that was set.\r
-\r
-**/\r
-#define PcdSetEx64(Guid, TokenName, Value)  LibPcdSetEx64  ((Guid), PcdTokenEx(Guid,TokenName), (Value))\r
-\r
-\r
-/**\r
-  Sets a pointer to a PCD token buffer based on a GUID and a token name.\r
-\r
-  Sets the buffer for the token specified by Guid and TokenName. Buffer is returned.\r
-  If SizeOfBuffer is greater than the maximum size supported by Guid and TokenName,\r
-  then set SizeOfBuffer to the maximum size supported by Guid and TokenName and return\r
-  NULL to indicate that the set operation was not actually performed. If SizeOfBuffer\r
-  is set to MAX_ADDRESS, then SizeOfBuffer must be set to the maximum size supported by\r
-  Guid and TokenName and NULL must be returned.\r
-  If TokenName is not a valid token in the token space specified by Guid,\r
-  then the module will not build.\r
-\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   Guid           Pointer to a 128-bit unique value that designates\r
-                          which namespace to retrieve a value from.\r
-  @param   TokenName      The name of the PCD token to set the current value for.\r
-  @param   SizeOfBuffer   A pointer to the size, in bytes, of Buffer.\r
-  @param   Buffer         Pointer to the buffer to set.\r
-\r
-  @return Return the pointer to the Buffer that was set.\r
-\r
-**/\r
-#define PcdSetExPtr(Guid, TokenName, SizeOfBuffer, Buffer) \\r
-                                            LibPcdSetExPtr ((Guid), PcdTokenEx(Guid,TokenName), (SizeOfBuffer), (Buffer))\r
-\r
-\r
-/**\r
-  Sets a Boolean PCD token value based on a GUID and a token name.\r
-\r
-  Sets the Boolean value for the token specified by Guid and TokenName. Value is returned.\r
-  If TokenName is not a valid token in the token space specified by Guid,\r
-  then the module will not build.\r
-\r
-  If Guid is NULL, then ASSERT().\r
-\r
-  @param   Guid           Pointer to a 128-bit unique value that designates\r
-                          which namespace to retrieve a value from.\r
-  @param   TokenName      The name of the PCD token to set the current value for.\r
-  @param   Value          The Boolean value to set.\r
-\r
-  @return Return the Value that was set.\r
-\r
-**/\r
-#define PcdSetExBool(Guid, TokenName, Value) \\r
-                                            LibPcdSetExBool((Guid), PcdTokenEx(Guid,TokenName), (Value))\r
-#endif\r
-\r
 /**\r
   Sets an 8-bit PCD token value based on a GUID and a token name.\r
 \r
@@ -1348,295 +1117,6 @@ LibPcdGetExSize (
   );\r
 \r
 \r
-#ifndef DISABLE_NEW_DEPRECATED_INTERFACES\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.  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
-\r
-  @return Return the Value that was set.\r
-\r
-**/\r
-UINT8\r
-EFIAPI\r
-LibPcdSet8 (\r
-  IN UINTN             TokenNumber,\r
-  IN UINT8             Value\r
-  );\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.  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
-\r
-  @return Return the Value that was set.\r
-\r
-**/\r
-UINT16\r
-EFIAPI\r
-LibPcdSet16 (\r
-  IN UINTN             TokenNumber,\r
-  IN UINT16            Value\r
-  );\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.  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
-\r
-  @return Return the Value that was set.\r
-\r
-**/\r
-UINT32\r
-EFIAPI\r
-LibPcdSet32 (\r
-  IN UINTN             TokenNumber,\r
-  IN UINT32            Value\r
-  );\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.  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
-\r
-  @return Return the Value that was set.\r
-\r
-**/\r
-UINT64\r
-EFIAPI\r
-LibPcdSet64 (\r
-  IN UINTN             TokenNumber,\r
-  IN UINT64            Value\r
-  );\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\r
-  specified by Buffer and SizeOfBuffer.  Buffer is returned.\r
-  If SizeOfBuffer is greater than the maximum size support by TokenNumber,\r
-  then set SizeOfBuffer to the maximum size supported by TokenNumber and\r
-  return NULL to indicate that the set operation 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 NULL must be returned.\r
-\r
-  If SizeOfBuffer is NULL, then ASSERT().\r
-  If SizeOfBuffer > 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
-\r
-  @return Return the pointer for the Buffer that was set.\r
-\r
-**/\r
-VOID *\r
-EFIAPI\r
-LibPcdSetPtr (\r
-  IN        UINTN             TokenNumber,\r
-  IN OUT    UINTN             *SizeOfBuffer,\r
-  IN CONST  VOID              *Buffer\r
-  );\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.  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
-\r
-  @return Return the Value that was set.\r
-\r
-**/\r
-BOOLEAN\r
-EFIAPI\r
-LibPcdSetBool (\r
-  IN UINTN             TokenNumber,\r
-  IN BOOLEAN           Value\r
-  );\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 and\r
-  Guid to the value specified by Value. Value is returned.\r
-\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 that was set.\r
-\r
-**/\r
-UINT8\r
-EFIAPI\r
-LibPcdSetEx8 (\r
-  IN CONST GUID        *Guid,\r
-  IN UINTN             TokenNumber,\r
-  IN UINT8             Value\r
-  );\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 and\r
-  Guid to the value specified by Value. Value is returned.\r
-\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 that was set.\r
-\r
-**/\r
-UINT16\r
-EFIAPI\r
-LibPcdSetEx16 (\r
-  IN CONST GUID        *Guid,\r
-  IN UINTN             TokenNumber,\r
-  IN UINT16            Value\r
-  );\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 and\r
-  Guid to the value specified by Value. Value is returned.\r
-\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 that was set.\r
-\r
-**/\r
-UINT32\r
-EFIAPI\r
-LibPcdSetEx32 (\r
-  IN CONST GUID        *Guid,\r
-  IN UINTN             TokenNumber,\r
-  IN UINT32            Value\r
-  );\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 and\r
-  Guid to the value specified by Value. Value is returned.\r
-\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 that was set.\r
-\r
-**/\r
-UINT64\r
-EFIAPI\r
-LibPcdSetEx64 (\r
-  IN CONST GUID        *Guid,\r
-  IN UINTN             TokenNumber,\r
-  IN UINT64            Value\r
-  );\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.  Buffer is returned.  If SizeOfBuffer is greater than\r
-  the maximum size support by TokenNumber, then set SizeOfBuffer 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 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 pointer to the Buffer that was set.\r
-\r
-**/\r
-VOID *\r
-EFIAPI\r
-LibPcdSetExPtr (\r
-  IN      CONST GUID        *Guid,\r
-  IN      UINTN             TokenNumber,\r
-  IN OUT  UINTN             *SizeOfBuffer,\r
-  IN      VOID              *Buffer\r
-  );\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 and\r
-  Guid to the value specified by Value. Value is returned.\r
-\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 that was set.\r
-\r
-**/\r
-BOOLEAN\r
-EFIAPI\r
-LibPcdSetExBool (\r
-  IN CONST GUID        *Guid,\r
-  IN UINTN             TokenNumber,\r
-  IN BOOLEAN           Value\r
-  );\r
-#endif\r
-\r
 /**\r
   This function provides a means by which to set a value for a given PCD token.\r
 \r