]> git.proxmox.com Git - mirror_edk2.git/blobdiff - MdePkg/Include/Library/PcdLib.h
Add BlockIO revision 3 definition. Add new API ScsiInquiryCommandEx to UefiScsiLib.
[mirror_edk2.git] / MdePkg / Include / Library / PcdLib.h
index 20c7765f418ccce3d3048d12967d5b20fc3d3842..8deb6f758e07126b61abac1d677bc0f332974e4b 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
@@ -14,8 +14,8 @@
   There are no restrictions on the use of FeaturePcd(), FixedPcdGetXX(),\r
   PatchPcdGetXX(), and PatchPcdSetXX().\r
 \r
-Copyright (c) 2006 - 2008, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>\r
+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
@@ -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