MdePkg and MdeModulePkg Pcd: Implement PCD Driver for External PCD Database and SKU enable Feature.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Bob C Feng <bob.c.feng@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>
Reviewed-by: Star Zeng <star.zeng@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@14857 6f19259b-4bc3-4df7-8a09-765794883524

2 files changed, 20 insertions, 30 deletions

diff --git a/MdePkg/Include/Ppi/Pcd.h b/MdePkg/Include/Ppi/Pcd.h
index da250a59ed..79e9c3e971 100644
--- a/MdePkg/Include/Ppi/Pcd.h
+++ b/MdePkg/Include/Ppi/Pcd.h
@@ -6,7 +6,7 @@
   The interfaces for dynamic type PCD do not require the token space guid as parameter,

   but interfaces for dynamic-ex type PCD require token space guid as parameter.

 

-Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>

+Copyright (c) 2006 - 2013, Intel Corporation. All rights reserved.<BR>

 This program and the accompanying materials are licensed and made available under 

 the terms and conditions of the BSD License that accompanies this distribution.  

 The full text of the license may be found at

@@ -775,10 +775,8 @@ EFI_STATUS
                                is being made to retrieve tokens from the default token space.

   @param[in, out]  TokenNumber A pointer to the PCD token number to use to find the subsequent token number.

                    

-  @retval EFI_SUCCESS   The PCD service has retrieved the next valid token number. 

-                        Or the input token number is already the last valid token number in the PCD database. 

-                        In the later case, *TokenNumber is updated with the value of 0.

-  @retval EFI_NOT_FOUND If this input token number and token namespace does not exist on the platform.

+  @retval EFI_SUCCESS   The PCD service has retrieved the next valid token number.

+  @retval EFI_NOT_FOUND The PCD service could not find data from the requested token number.

 

 **/

 typedef 

@@ -793,25 +791,17 @@ EFI_STATUS
 /**

   Retrieves the next valid PCD token namespace for a given namespace.

 

-  If *Guid is NULL, then the GUID of the first token space of the 

-  current platform is assigned to *Guid the function return EFI_SUCCESS. 

-  If  *Guid is NULL  and there is no namespace exist in the platform other than the default 

-  (NULL) tokennamespace, *Guid is unchanged and the function return EFI_SUCCESS. 

-  If this input token namespace is the last namespace on the platform, 

-  *Guid will be assigned to NULL and the function return EFI_SUCCESS.

-

-  @param[in, out]  Guid An indirect pointer to EFI_GUID.  On input it designates a known 

-                        token namespace from which the search will start. On output, it designates 

-                        the next valid token namespace on the platform. If the input token namespace 

-                        does not exist on the platform, an error is returned, and the value of *Guid is 

-                        undefined.

-

-  @retval EFI_SUCCESS  The PCD service has retrieved the next valid token namespace. 

-                        Or the input token namespace is already the last valid token 

-                        number in the PCD database. In the later case, *Guid is updated 

-                        with the value of NULL. Or the input token name space is NULL and there 

-                        is no valid token namespace other than the default namespace (NULL).

-  @retval EFI_NOT_FOUND If the input token namespace does not exist on the platform.

+  Gets the next valid token namespace for a given namespace. This is useful to traverse the valid

+  token namespaces on a platform.

+

+  @param[in, out]   Guid    An indirect pointer to EFI_GUID. On input it designates a known token

+                            namespace from which the search will start. On output, it designates the next valid

+                            token namespace on the platform. If *Guid is NULL, then the GUID of the first token

+                            space of the current platform is returned. If the search cannot locate the next valid

+                            token namespace, an error is returned and the value of *Guid is undefined.

+ 

+  @retval  EFI_SUCCESS      The PCD service retrieved the value requested.

+  @retval  EFI_NOT_FOUND    The PCD service could not find the next valid token namespace.

 

 **/

 typedef

diff --git a/MdePkg/Include/Ppi/PiPcd.h b/MdePkg/Include/Ppi/PiPcd.h
index d116dc230f..4698ecc3ad 100644
--- a/MdePkg/Include/Ppi/PiPcd.h
+++ b/MdePkg/Include/Ppi/PiPcd.h
@@ -1,18 +1,17 @@
 /** @file

-  Platform Configuration Database (PCD) Protocol defined in PI 1.2 Vol3

+  Platform Configuration Database (PCD) PPI defined in PI 1.2 Vol3

 

   A platform database that contains a variety of current platform settings or

   directives that can be accessed by a driver or application.

-  PI PCD protocol only provide the accessing interfaces for Dynamic-Ex type PCD.

+  PI PCD ppi only provide the accessing interfaces for Dynamic-Ex type PCD.

 

-  Callers to this protocol must be at a TPL_APPLICATION task priority level.

   This is the base PCD service API that provides an abstraction for accessing configuration content in

   the platform. It a seamless mechanism for extracting information regardless of where the

   information is stored (such as in Read-only data, or an EFI Variable).

   This protocol allows access to data through size-granular APIs and provides a mechanism for a

   firmware component to monitor specific settings and be alerted when a setting is changed.

 

-  Copyright (c) 2009 - 2010, Intel Corporation. All rights reserved.<BR>

+  Copyright (c) 2009 - 2013, Intel Corporation. All rights reserved.<BR>

   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

@@ -73,7 +72,7 @@ UINT8
 );

 

 /**

-  Retrieves the current byte-sized value for a PCD token number. If the TokenNumber is invalid,

+  Retrieves the current word-sized value for a PCD token number. If the TokenNumber is invalid,

   the results are unpredictable.

 

   @param[in]    Guid          The 128-bit unique value that designates which namespace to extract the value from.

@@ -375,7 +374,8 @@ EFI_STATUS
   know what token numbers are valid in the database.

 

   @param[in]    Guid          The 128-bit unique value that designates which namespace to extract the value from.

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

+  @param[in]    TokenNumber   A pointer to the PCD token number to use to find the subsequent token number. To

+                              retrieve the "first" token, have the pointer reference a TokenNumber value of 0.

 

   @retval   EFI_SUCCESS       The PCD service has retrieved the value requested.

   @retval   EFI_NOT_FOUND     The PCD service could not find data from the requested token number.