]> git.proxmox.com Git - mirror_edk2.git/blobdiff - MdePkg/Include/Library/PcdLib.h
update codes per MdePkg doxgen review comments.
[mirror_edk2.git] / MdePkg / Include / Library / PcdLib.h
index 20c7765f418ccce3d3048d12967d5b20fc3d3842..00548bebc4e0845e51f73853cae7699e02035415 100644 (file)
@@ -6,7 +6,7 @@
   PCD, module should be linked to a PEIM/DXE library instance to access that PCD.\r
   If a module uses PatchableInModule type PCD, it also needs the library instance to produce\r
   LibPatchPcdSetPtr() interface. For FeatureFlag/Fixed PCD, the macro interface is\r
-  translated to n variable or macro that is auto-generated by build tool in\r
+  translated to a variable or macro that is auto-generated by build tool in\r
   module's autogen.h/autogen.c.\r
   The PcdGetXX(), PcdSetXX(), PcdToken(), and PcdGetNextTokenSpace() operations are \r
   only available prior to ExitBootServices().  If access to PCD values are required \r
@@ -250,7 +250,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
   @param   TokenName  The name of the binary patchable PCD token to set the current value for.\r
   @param   Value      The 8-bit value to set.\r
   \r
-  @return  Value.\r
+  @return Return the Value that was set.\r
 \r
 **/\r
 #define PatchPcdSet8(TokenName, Value)      (_gPcd_BinaryPatch_##TokenName = (Value))\r
@@ -266,7 +266,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
   @param   TokenName  The name of the binary patchable PCD token to set the current value for.\r
   @param   Value      The 16-bit value to set.\r
 \r
-  @return  Value.\r
+  @return Return the Value that was set.\r
 \r
 **/\r
 #define PatchPcdSet16(TokenName, Value)     (_gPcd_BinaryPatch_##TokenName = (Value))\r
@@ -282,7 +282,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
   @param   TokenName  The name of the binary patchable PCD token to set the current value for.\r
   @param   Value      The 32-bit value to set.\r
 \r
-  @return  Value.\r
+  @return Return the Value that was set.\r
 \r
 **/\r
 #define PatchPcdSet32(TokenName, Value)     (_gPcd_BinaryPatch_##TokenName = (Value))\r
@@ -298,7 +298,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
   @param   TokenName  The name of the binary patchable PCD token to set the current value for.\r
   @param   Value      The 64-bit value to set.\r
 \r
-  @return  Value.\r
+  @return Return the Value that was set.\r
 \r
 **/\r
 #define PatchPcdSet64(TokenName, Value)     (_gPcd_BinaryPatch_##TokenName = (Value))\r
@@ -314,7 +314,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
   @param   TokenName  The name of the binary patchable PCD token to set the current value for.\r
   @param   Value      The boolean value to set.\r
 \r
-  @return  Value.\r
+  @return Return the Value that was set.\r
 \r
 **/\r
 #define PatchPcdSetBool(TokenName, Value)   (_gPcd_BinaryPatch_##TokenName = (Value))\r
@@ -338,7 +338,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
   @param   SizeOfBuffer   A pointer to the size, in bytes, of Buffer.\r
   @param   Buffer         Pointer to the value to set.\r
 \r
-  @return  Value.\r
+  @return Return the pointer to the Buffer that was set.\r
 \r
 **/\r
 #define PatchPcdSetPtr(TokenName, Size, Buffer) \\r
@@ -442,7 +442,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
   @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  Value.\r
+  @return Return the Value that was set.\r
 \r
 **/\r
 #define PcdSet8(TokenName, Value)           _PCD_SET_MODE_8_##TokenName     ((Value))\r
@@ -457,7 +457,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
   @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  Value.\r
+  @return Return the Value that was set.\r
 \r
 **/\r
 #define PcdSet16(TokenName, Value)          _PCD_SET_MODE_16_##TokenName    ((Value))\r
@@ -472,7 +472,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
   @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  Value.\r
+  @return Return the Value that was set.\r
 \r
 **/\r
 #define PcdSet32(TokenName, Value)          _PCD_SET_MODE_32_##TokenName    ((Value))\r
@@ -487,7 +487,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
   @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  Value.\r
+  @return Return the Value that was set.\r
 \r
 **/\r
 #define PcdSet64(TokenName, Value)          _PCD_SET_MODE_64_##TokenName    ((Value))\r
@@ -511,7 +511,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
   @param   SizeOfBuffer   A pointer to the size, in bytes, of Buffer.\r
   @param   Buffer         A pointer to the buffer to set.\r
 \r
-  @return  Buffer.\r
+  @return Return the pointer to the Buffer that was set.\r
 \r
 **/\r
 #define PcdSetPtr(TokenName, SizeOfBuffer, Buffer) \\r
@@ -526,7 +526,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
   @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  Value. \r
+  @return Return the Value that was set.\r
 \r
 **/\r
 #define PcdSetBool(TokenName, Value)        _PCD_SET_MODE_BOOL_##TokenName  ((Value))\r
@@ -660,7 +660,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
   @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  Value. \r
+  @return Return the Value that was set.\r
 \r
 **/\r
 #define PcdSetEx8(Guid, TokenName, Value)   LibPcdSetEx8   ((Guid), _PCD_TOKEN_##TokenName, (Value))\r
@@ -680,7 +680,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
   @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  Value. \r
+  @return Return the Value that was set.\r
 \r
 **/\r
 #define PcdSetEx16(Guid, TokenName, Value)  LibPcdSetEx16  ((Guid), _PCD_TOKEN_##TokenName, (Value))\r
@@ -700,7 +700,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
   @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  Value. \r
+  @return Return the Value that was set.\r
 \r
 **/\r
 #define PcdSetEx32(Guid, TokenName, Value)  LibPcdSetEx32  ((Guid), _PCD_TOKEN_##TokenName, (Value))\r
@@ -720,7 +720,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
   @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  Value. \r
+  @return Return the Value that was set.\r
 \r
 **/\r
 #define PcdSetEx64(Guid, TokenName, Value)  LibPcdSetEx64  ((Guid), _PCD_TOKEN_##TokenName, (Value))\r
@@ -746,9 +746,9 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
                           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   Value          Pointer to the buffer to set.\r
+  @param   Buffer         Pointer to the buffer to set.\r
     \r
-  @return  Buffer. \r
+  @return Return the pointer to the Buffer that was set.\r
 \r
 **/\r
 #define PcdSetExPtr(Guid, TokenName, SizeOfBuffer, Buffer) \\r
@@ -769,7 +769,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
   @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  Value. \r
+  @return Return the Value that was set.\r
 \r
 **/                                         \r
 #define PcdSetExBool(Guid, TokenName, Value) \\r
@@ -1072,7 +1072,7 @@ LibPcdGetExSize (
   @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
+  @return Return the Value that was set.\r
 \r
 **/\r
 UINT8\r
@@ -1092,7 +1092,7 @@ LibPcdSet8 (
   @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
+  @return Return the Value that was set.\r
 \r
 **/\r
 UINT16\r
@@ -1112,7 +1112,7 @@ LibPcdSet16 (
   @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
+  @return Return the Value that was set.\r
 \r
 **/\r
 UINT32\r
@@ -1132,7 +1132,7 @@ LibPcdSet32 (
   @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
+  @return Return the Value that was set.\r
 \r
 **/\r
 UINT64\r
@@ -1162,7 +1162,7 @@ LibPcdSet64 (
   @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
+  @return Return the pointer for the Buffer that was set.\r
 \r
 **/\r
 VOID *\r
@@ -1183,7 +1183,7 @@ LibPcdSetPtr (
   @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
+  @return Return the Value that was set.\r
 \r
 **/\r
 BOOLEAN\r
@@ -1207,7 +1207,7 @@ LibPcdSetBool (
   @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
+  @return Return the Value that was set.\r
 \r
 **/\r
 UINT8\r
@@ -1232,7 +1232,7 @@ LibPcdSetEx8 (
   @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
+  @return Return the Value that was set.\r
 \r
 **/\r
 UINT16\r
@@ -1257,7 +1257,7 @@ LibPcdSetEx16 (
   @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
+  @return Return the Value that was set.\r
 \r
 **/\r
 UINT32\r
@@ -1281,7 +1281,7 @@ LibPcdSetEx32 (
   @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
+  @return Return the Value that was set.\r
 \r
 **/\r
 UINT64\r
@@ -1312,7 +1312,7 @@ LibPcdSetEx64 (
   @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
+  @return Return the pointer to the Buffer that was set.\r
 \r
 **/\r
 VOID *\r
@@ -1338,7 +1338,7 @@ LibPcdSetExPtr (
   @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
+  @return Return the Value that was set.\r
 \r
 **/\r
 BOOLEAN\r
@@ -1491,7 +1491,7 @@ LibPcdGetNextTokenSpace (
   @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
+  @return Return the pointer to the Buffer that was set.\r
 \r
 **/\r
 VOID *\r