mirror of https://github.com/acidanthera/audk.git
1507 lines
50 KiB
C++
1507 lines
50 KiB
C++
/** @file
|
|
Provides library services to get and set Platform Configuration Database entries.
|
|
|
|
PCD Library Class provides a PCD usage macro interface for all PCD types.
|
|
It should be included in any module that uses PCD. If a module uses dynamic/dynamicex
|
|
PCD, module should be linked to a PEIM/DXE library instance to access that PCD.
|
|
If a module uses PatchableInModule type PCD, it also needs the library instance to produce
|
|
LibPatchPcdSetPtr() interface. For FeatureFlag/Fixed PCD, the macro interface is
|
|
translated to a variable or macro that is auto-generated by build tool in
|
|
module's autogen.h/autogen.c.
|
|
The PcdGetXX(), PcdSetXX(), PcdToken(), and PcdGetNextTokenSpace() operations are
|
|
only available prior to ExitBootServices(). If access to PCD values are required
|
|
at runtime, then their values must be collected prior to ExitBootServices().
|
|
There are no restrictions on the use of FeaturePcd(), FixedPcdGetXX(),
|
|
PatchPcdGetXX(), and PatchPcdSetXX().
|
|
|
|
Copyright (c) 2006 - 2008, 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.
|
|
|
|
**/
|
|
|
|
#ifndef __PCD_LIB_H__
|
|
#define __PCD_LIB_H__
|
|
|
|
#define PCD_MAX_SKU_ID 0x100
|
|
|
|
|
|
/**
|
|
Retrieves a token number based on a token name.
|
|
|
|
Returns the token number associated with the PCD token specified by TokenName.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
If TokenName is not a feature flag, then the module will not build.
|
|
|
|
@param TokenName The name of the PCD token to retrieve the token number for.
|
|
|
|
@return The token number associated with the PCD.
|
|
|
|
**/
|
|
#define PcdToken(TokenName) _PCD_TOKEN_##TokenName
|
|
|
|
|
|
/**
|
|
Retrieves a Boolean PCD feature flag based on a token name.
|
|
|
|
Returns the Boolean value for the PCD feature flag specified by TokenName.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
If TokenName is not a feature flag, then the module will not build.
|
|
|
|
@param TokenName The name of the PCD token to retrieve a current value for.
|
|
|
|
@return Boolean value for the PCD feature flag.
|
|
|
|
**/
|
|
#define FeaturePcdGet(TokenName) _PCD_GET_MODE_BOOL_##TokenName
|
|
|
|
|
|
/**
|
|
Retrieves an 8-bit fixed PCD token value based on a token name.
|
|
|
|
Returns the 8-bit value for the token specified by TokenName.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
If TokenName is not a feature flag, then the module will not build.
|
|
|
|
@param TokenName The name of the PCD token to retrieve a current value for.
|
|
|
|
@return 8-bit value for the token specified by TokenName.
|
|
|
|
**/
|
|
#define FixedPcdGet8(TokenName) _PCD_VALUE_##TokenName
|
|
|
|
|
|
/**
|
|
Retrieves a 16-bit fixed PCD token value based on a token name.
|
|
|
|
Returns the 16-bit value for the token specified by TokenName.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
If TokenName is not a feature flag, then the module will not build.
|
|
|
|
@param TokenName The name of the PCD token to retrieve a current value for.
|
|
|
|
@return 16-bit value for the token specified by TokenName.
|
|
|
|
**/
|
|
#define FixedPcdGet16(TokenName) _PCD_VALUE_##TokenName
|
|
|
|
|
|
/**
|
|
Retrieves a 32-bit fixed PCD token value based on a token name.
|
|
|
|
Returns the 32-bit value for the token specified by TokenName.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
If TokenName is not a feature flag, then the module will not build.
|
|
|
|
@param TokenName The name of the PCD token to retrieve a current value for.
|
|
|
|
@return 32-bit value for the token specified by TokenName.
|
|
|
|
**/
|
|
#define FixedPcdGet32(TokenName) _PCD_VALUE_##TokenName
|
|
|
|
|
|
/**
|
|
Retrieves a 64-bit fixed PCD token value based on a token name.
|
|
|
|
Returns the 64-bit value for the token specified by TokenName.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
If TokenName is not a feature flag, then the module will not build.
|
|
|
|
@param TokenName The name of the PCD token to retrieve a current value for.
|
|
|
|
@return 64-bit value for the token specified by TokenName.
|
|
|
|
**/
|
|
#define FixedPcdGet64(TokenName) _PCD_VALUE_##TokenName
|
|
|
|
|
|
/**
|
|
Retrieves a Boolean fixed PCD token value based on a token name.
|
|
|
|
Returns the Boolean value for the token specified by TokenName.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
If TokenName is not a feature flag, then the module will not build.
|
|
|
|
@param TokenName The name of the PCD token to retrieve a current value for.
|
|
|
|
@return The Boolean value for the token.
|
|
|
|
**/
|
|
#define FixedPcdGetBool(TokenName) _PCD_VALUE_##TokenName
|
|
|
|
|
|
/**
|
|
Retrieves a pointer to a fixed PCD token buffer based on a token name.
|
|
|
|
Returns a pointer to the buffer for the token specified by TokenName.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
If TokenName is not a feature flag, then the module will not build.
|
|
|
|
@param TokenName The name of the PCD token to retrieve a current value for.
|
|
|
|
@return A pointer to the buffer.
|
|
|
|
**/
|
|
#define FixedPcdGetPtr(TokenName) ((VOID *)_PCD_VALUE_##TokenName)
|
|
|
|
|
|
/**
|
|
Retrieves an 8-bit binary patchable PCD token value based on a token name.
|
|
|
|
Returns the 8-bit value for the token specified by TokenName.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
If TokenName is not a feature flag, then the module will not build.
|
|
|
|
@param TokenName The name of the PCD token to retrieve a current value for.
|
|
|
|
@return An 8-bit binary patchable PCD token value.
|
|
|
|
**/
|
|
#define PatchPcdGet8(TokenName) _gPcd_BinaryPatch_##TokenName
|
|
|
|
/**
|
|
Retrieves a 16-bit binary patchable PCD token value based on a token name.
|
|
|
|
Returns the 16-bit value for the token specified by TokenName.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
If TokenName is not a feature flag, then the module will not build.
|
|
|
|
@param TokenName The name of the PCD token to retrieve a current value for.
|
|
|
|
@return A 16-bit binary patchable PCD token value.
|
|
|
|
**/
|
|
#define PatchPcdGet16(TokenName) _gPcd_BinaryPatch_##TokenName
|
|
|
|
|
|
/**
|
|
Retrieves a 32-bit binary patchable PCD token value based on a token name.
|
|
|
|
Returns the 32-bit value for the token specified by TokenName.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
If TokenName is not a feature flag, then the module will not build.
|
|
|
|
@param TokenName The name of the PCD token to retrieve a current value for.
|
|
|
|
@return A 32-bit binary patchable PCD token value.
|
|
|
|
**/
|
|
#define PatchPcdGet32(TokenName) _gPcd_BinaryPatch_##TokenName
|
|
|
|
|
|
/**
|
|
Retrieves a 64-bit binary patchable PCD token value based on a token name.
|
|
|
|
Returns the 64-bit value for the token specified by TokenName.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
If TokenName is not a feature flag, then the module will not build.
|
|
|
|
@param TokenName The name of the PCD token to retrieve a current value for.
|
|
|
|
@return A 64-bit binary patchable PCD token value.
|
|
|
|
**/
|
|
#define PatchPcdGet64(TokenName) _gPcd_BinaryPatch_##TokenName
|
|
|
|
|
|
/**
|
|
Retrieves a Boolean binary patchable PCD token value based on a token name.
|
|
|
|
Returns the Boolean value for the token specified by TokenName.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
If TokenName is not a feature flag, then the module will not build.
|
|
|
|
@param TokenName The name of the PCD token to retrieve a current value for.
|
|
|
|
@return The Boolean value for the token.
|
|
|
|
**/
|
|
#define PatchPcdGetBool(TokenName) _gPcd_BinaryPatch_##TokenName
|
|
|
|
|
|
/**
|
|
Retrieves a pointer to a binary patchable PCD token buffer based on a token name.
|
|
|
|
Returns a pointer to the buffer for the token specified by TokenName.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
If TokenName is not a feature flag, then the module will not build.
|
|
|
|
@param TokenName The name of the PCD token to retrieve a current value for.
|
|
|
|
@return A pointer to the buffer for the token.
|
|
|
|
**/
|
|
#define PatchPcdGetPtr(TokenName) ((VOID *)_gPcd_BinaryPatch_##TokenName)
|
|
|
|
|
|
/**
|
|
Sets an 8-bit binary patchable PCD token value based on a token name.
|
|
|
|
Sets the 8-bit value for the token specified by TokenName. Value is returned.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
If TokenName is not a feature flag, then the module will not build.
|
|
|
|
@param TokenName The name of the binary patchable PCD token to set the current value for.
|
|
@param Value The 8-bit value to set.
|
|
|
|
@return Return the Value that was set.
|
|
|
|
**/
|
|
#define PatchPcdSet8(TokenName, Value) (_gPcd_BinaryPatch_##TokenName = (Value))
|
|
|
|
|
|
/**
|
|
Sets a 16-bit binary patchable PCD token value based on a token name.
|
|
|
|
Sets the 16-bit value for the token specified by TokenName. Value is returned.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
If TokenName is not a feature flag, then the module will not build.
|
|
|
|
@param TokenName The name of the binary patchable PCD token to set the current value for.
|
|
@param Value The 16-bit value to set.
|
|
|
|
@return Return the Value that was set.
|
|
|
|
**/
|
|
#define PatchPcdSet16(TokenName, Value) (_gPcd_BinaryPatch_##TokenName = (Value))
|
|
|
|
|
|
/**
|
|
Sets a 32-bit binary patchable PCD token value based on a token name.
|
|
|
|
Sets the 32-bit value for the token specified by TokenName. Value is returned.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
If TokenName is not a feature flag, then the module will not build.
|
|
|
|
@param TokenName The name of the binary patchable PCD token to set the current value for.
|
|
@param Value The 32-bit value to set.
|
|
|
|
@return Return the Value that was set.
|
|
|
|
**/
|
|
#define PatchPcdSet32(TokenName, Value) (_gPcd_BinaryPatch_##TokenName = (Value))
|
|
|
|
|
|
/**
|
|
Sets a 64-bit binary patchable PCD token value based on a token name.
|
|
|
|
Sets the 64-bit value for the token specified by TokenName. Value is returned.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
If TokenName is not a feature flag, then the module will not build.
|
|
|
|
@param TokenName The name of the binary patchable PCD token to set the current value for.
|
|
@param Value The 64-bit value to set.
|
|
|
|
@return Return the Value that was set.
|
|
|
|
**/
|
|
#define PatchPcdSet64(TokenName, Value) (_gPcd_BinaryPatch_##TokenName = (Value))
|
|
|
|
|
|
/**
|
|
Sets a Boolean binary patchable PCD token value based on a token name.
|
|
|
|
Sets the Boolean value for the token specified by TokenName. Value is returned.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
If TokenName is not a feature flag, then the module will not build.
|
|
|
|
@param TokenName The name of the binary patchable PCD token to set the current value for.
|
|
@param Value The boolean value to set.
|
|
|
|
@return Return the Value that was set.
|
|
|
|
**/
|
|
#define PatchPcdSetBool(TokenName, Value) (_gPcd_BinaryPatch_##TokenName = (Value))
|
|
|
|
|
|
/**
|
|
Sets a pointer to a binary patchable PCD token buffer based on a token name.
|
|
|
|
Sets the buffer for the token specified by TokenName. Buffer is returned.
|
|
If SizeOfBuffer is greater than the maximum size supported by TokenName, then set SizeOfBuffer
|
|
to the maximum size supported by TokenName and return NULL to indicate that the set operation
|
|
was not actually performed. If SizeOfBuffer is set to MAX_ADDRESS, then SizeOfBuffer must be
|
|
set to the maximum size supported by TokenName and NULL must be returned.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
If TokenName is not a feature flag, then the module will not build.
|
|
|
|
If SizeOfBuffer is NULL, then ASSERT().
|
|
If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().
|
|
|
|
@param TokenName The name of the binary patchable PCD token to set the current value for.
|
|
@param SizeOfBuffer A pointer to the size, in bytes, of Buffer.
|
|
@param Buffer Pointer to the value to set.
|
|
|
|
@return Return the pointer to the Buffer that was set.
|
|
|
|
**/
|
|
#define PatchPcdSetPtr(TokenName, Size, Buffer) \
|
|
LibPatchPcdSetPtr ( \
|
|
_gPcd_BinaryPatch_##TokenName, \
|
|
(UINTN)_PCD_PATCHABLE_##TokenName##_SIZE, \
|
|
(Size), \
|
|
(Buffer) \
|
|
)
|
|
|
|
/**
|
|
Retrieves an 8-bit PCD token value based on a token name.
|
|
|
|
Returns the 8-bit value for the token specified by TokenName.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
|
|
@param TokenName The name of the PCD token to retrieve a current value for.
|
|
|
|
@return 8-bit value for the token specified by TokenName.
|
|
|
|
**/
|
|
#define PcdGet8(TokenName) _PCD_GET_MODE_8_##TokenName
|
|
|
|
|
|
/**
|
|
Retrieves a 16-bit PCD token value based on a token name.
|
|
|
|
Returns the 16-bit value for the token specified by TokenName.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
|
|
@param TokenName The name of the PCD token to retrieve a current value for.
|
|
|
|
@return 16-bit value for the token specified by TokenName.
|
|
|
|
**/
|
|
#define PcdGet16(TokenName) _PCD_GET_MODE_16_##TokenName
|
|
|
|
|
|
/**
|
|
Retrieves a 32-bit PCD token value based on a token name.
|
|
|
|
Returns the 32-bit value for the token specified by TokenName.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
|
|
@param TokenName The name of the PCD token to retrieve a current value for.
|
|
|
|
@return 32-bit value for the token specified by TokenName.
|
|
|
|
**/
|
|
#define PcdGet32(TokenName) _PCD_GET_MODE_32_##TokenName
|
|
|
|
|
|
/**
|
|
Retrieves a 64-bit PCD token value based on a token name.
|
|
|
|
Returns the 64-bit value for the token specified by TokenName.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
|
|
@param TokenName The name of the PCD token to retrieve a current value for.
|
|
|
|
@return 64-bit value for the token specified by TokenName.
|
|
|
|
**/
|
|
#define PcdGet64(TokenName) _PCD_GET_MODE_64_##TokenName
|
|
|
|
|
|
/**
|
|
Retrieves a pointer to a PCD token buffer based on a token name.
|
|
|
|
Returns a pointer to the buffer for the token specified by TokenName.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
|
|
@param TokenName The name of the PCD token to retrieve a current value for.
|
|
|
|
@return A pointer to the buffer.
|
|
|
|
**/
|
|
#define PcdGetPtr(TokenName) _PCD_GET_MODE_PTR_##TokenName
|
|
|
|
|
|
/**
|
|
Retrieves a Boolean PCD token value based on a token name.
|
|
|
|
Returns the Boolean value for the token specified by TokenName.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
|
|
@param TokenName The name of the PCD token to retrieve a current value for.
|
|
|
|
@return A Boolean PCD token value.
|
|
|
|
**/
|
|
#define PcdGetBool(TokenName) _PCD_GET_MODE_BOOL_##TokenName
|
|
|
|
|
|
/**
|
|
Sets an 8-bit PCD token value based on a token name.
|
|
|
|
Sets the 8-bit value for the token specified by TokenName. Value is returned.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
|
|
@param TokenName The name of the PCD token to retrieve a current value for.
|
|
@param Value The 8-bit value to set.
|
|
|
|
@return Return the Value that was set.
|
|
|
|
**/
|
|
#define PcdSet8(TokenName, Value) _PCD_SET_MODE_8_##TokenName ((Value))
|
|
|
|
|
|
/**
|
|
Sets a 16-bit PCD token value based on a token name.
|
|
|
|
Sets the 16-bit value for the token specified by TokenName. Value is returned.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
|
|
@param TokenName The name of the PCD token to retrieve a current value for.
|
|
@param Value The 16-bit value to set.
|
|
|
|
@return Return the Value that was set.
|
|
|
|
**/
|
|
#define PcdSet16(TokenName, Value) _PCD_SET_MODE_16_##TokenName ((Value))
|
|
|
|
|
|
/**
|
|
Sets a 32-bit PCD token value based on a token name.
|
|
|
|
Sets the 32-bit value for the token specified by TokenName. Value is returned.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
|
|
@param TokenName The name of the PCD token to retrieve a current value for.
|
|
@param Value The 32-bit value to set.
|
|
|
|
@return Return the Value that was set.
|
|
|
|
**/
|
|
#define PcdSet32(TokenName, Value) _PCD_SET_MODE_32_##TokenName ((Value))
|
|
|
|
|
|
/**
|
|
Sets a 64-bit PCD token value based on a token name.
|
|
|
|
Sets the 64-bit value for the token specified by TokenName. Value is returned.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
|
|
@param TokenName The name of the PCD token to retrieve a current value for.
|
|
@param Value The 64-bit value to set.
|
|
|
|
@return Return the Value that was set.
|
|
|
|
**/
|
|
#define PcdSet64(TokenName, Value) _PCD_SET_MODE_64_##TokenName ((Value))
|
|
|
|
|
|
/**
|
|
Sets a pointer to a PCD token buffer based on a token name.
|
|
|
|
Sets the buffer for the token specified by TokenName. Buffer is returned.
|
|
If SizeOfBuffer is greater than the maximum size supported by TokenName,
|
|
then set SizeOfBuffer to the maximum size supported by TokenName and return NULL
|
|
to indicate that the set operation was not actually performed. If SizeOfBuffer
|
|
is set to MAX_ADDRESS, then SizeOfBuffer must be set to the maximum size supported
|
|
by TokenName and NULL must be returned.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
|
|
If SizeOfBuffer is NULL, then ASSERT().
|
|
If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().
|
|
|
|
@param TokenName The name of the PCD token to set the current value for.
|
|
@param SizeOfBuffer A pointer to the size, in bytes, of Buffer.
|
|
@param Buffer A pointer to the buffer to set.
|
|
|
|
@return Return the pointer to the Buffer that was set.
|
|
|
|
**/
|
|
#define PcdSetPtr(TokenName, SizeOfBuffer, Buffer) \
|
|
_PCD_SET_MODE_PTR_##TokenName ((SizeOfBuffer), (Buffer))
|
|
|
|
/**
|
|
Sets a Boolean PCD token value based on a token name.
|
|
|
|
Sets the Boolean value for the token specified by TokenName. Value is returned.
|
|
If TokenName is not a valid token in the token space, then the module will not build.
|
|
|
|
@param TokenName The name of the PCD token to set the current value for.
|
|
@param Buffer The Boolean value to set.
|
|
|
|
@return Return the Value that was set.
|
|
|
|
**/
|
|
#define PcdSetBool(TokenName, Value) _PCD_SET_MODE_BOOL_##TokenName ((Value))
|
|
|
|
|
|
/**
|
|
Retrieves an 8-bit PCD token value based on a GUID and a token name.
|
|
|
|
Returns the 8-bit value for the token specified by Guid and TokenName.
|
|
If TokenName is not a valid token in the token space specified by Guid,
|
|
then the module will not build.
|
|
|
|
If Guid is NULL, then ASSERT().
|
|
|
|
@param Guid Pointer to a 128-bit unique value that designates
|
|
which namespace to retrieve a value from.
|
|
@param TokenName The name of the PCD token to retrieve a current value for.
|
|
|
|
@return An 8-bit PCD token value.
|
|
|
|
**/
|
|
#define PcdGetEx8(Guid, TokenName) LibPcdGetEx8 ((Guid), _PCD_TOKEN_##TokenName)
|
|
|
|
|
|
/**
|
|
Retrieves a 16-bit PCD token value based on a GUID and a token name.
|
|
|
|
Returns the 16-bit value for the token specified by Guid and TokenName.
|
|
If TokenName is not a valid token in the token space specified by Guid,
|
|
then the module will not build.
|
|
|
|
If Guid is NULL, then ASSERT().
|
|
|
|
@param Guid Pointer to a 128-bit unique value that designates
|
|
which namespace to retrieve a value from.
|
|
@param TokenName The name of the PCD token to retrieve a current value for.
|
|
|
|
@return A 16-bit PCD token value.
|
|
|
|
**/
|
|
#define PcdGetEx16(Guid, TokenName) LibPcdGetEx16 ((Guid), _PCD_TOKEN_##TokenName)
|
|
|
|
|
|
/**
|
|
Retrieves a 32-bit PCD token value based on a GUID and a token name.
|
|
|
|
Returns the 32-bit value for the token specified by Guid and TokenName.
|
|
If TokenName is not a valid token in the token space specified by Guid,
|
|
then the module will not build.
|
|
|
|
If Guid is NULL, then ASSERT().
|
|
|
|
@param Guid Pointer to a 128-bit unique value that designates
|
|
which namespace to retrieve a value from.
|
|
@param TokenName The name of the PCD token to retrieve a current value for.
|
|
|
|
@return A 32-bit PCD token value.
|
|
|
|
**/
|
|
#define PcdGetEx32(Guid, TokenName) LibPcdGetEx32 ((Guid), _PCD_TOKEN_##TokenName)
|
|
|
|
|
|
/**
|
|
Retrieves a 64-bit PCD token value based on a GUID and a token name.
|
|
|
|
Returns the 64-bit value for the token specified by Guid and TokenName.
|
|
If TokenName is not a valid token in the token space specified by Guid,
|
|
then the module will not build.
|
|
|
|
If Guid is NULL, then ASSERT().
|
|
|
|
@param Guid Pointer to a 128-bit unique value that designates
|
|
which namespace to retrieve a value from.
|
|
@param TokenName The name of the PCD token to retrieve a current value for.
|
|
|
|
@return A 64-bit PCD token value.
|
|
|
|
**/
|
|
#define PcdGetEx64(Guid, TokenName) LibPcdGetEx64 ((Guid), _PCD_TOKEN_##TokenName)
|
|
|
|
|
|
/**
|
|
Retrieves a pointer to a PCD token buffer based on a GUID and a token name.
|
|
|
|
Returns a pointer to the buffer for the token specified by Guid and TokenName.
|
|
If TokenName is not a valid token in the token space specified by Guid,
|
|
then the module will not build.
|
|
|
|
If Guid is NULL, then ASSERT().
|
|
|
|
@param Guid Pointer to a 128-bit unique value that designates
|
|
which namespace to retrieve a value from.
|
|
@param TokenName The name of the PCD token to retrieve a current value for.
|
|
|
|
@return A pointer to a PCD token buffer.
|
|
|
|
**/
|
|
#define PcdGetExPtr(Guid, TokenName) LibPcdGetExPtr ((Guid), _PCD_TOKEN_##TokenName)
|
|
|
|
|
|
/**
|
|
Retrieves a Boolean PCD token value based on a GUID and a token name.
|
|
|
|
Returns the Boolean value for the token specified by Guid and TokenName.
|
|
If TokenName is not a valid token in the token space specified by Guid,
|
|
then the module will not build.
|
|
|
|
If Guid is NULL, then ASSERT().
|
|
|
|
@param Guid Pointer to a 128-bit unique value that designates
|
|
which namespace to retrieve a value from.
|
|
@param TokenName The name of the PCD token to retrieve a current value for.
|
|
|
|
@return A Boolean PCD token value.
|
|
|
|
**/
|
|
#define PcdGetExBool(Guid, TokenName) LibPcdGetExBool ((Guid), _PCD_TOKEN_##TokenName)
|
|
|
|
|
|
/**
|
|
Sets an 8-bit PCD token value based on a GUID and a token name.
|
|
|
|
Sets the 8-bit value for the token specified by Guid and TokenName. Value is returned.
|
|
If TokenName is not a valid token in the token space specified by Guid,
|
|
then the module will not build.
|
|
|
|
If Guid is NULL, then ASSERT().
|
|
|
|
@param Guid Pointer to a 128-bit unique value that designates
|
|
which namespace to retrieve a value from.
|
|
@param TokenName The name of the PCD token to set the current value for.
|
|
@param Value The 8-bit value to set.
|
|
|
|
@return Return the Value that was set.
|
|
|
|
**/
|
|
#define PcdSetEx8(Guid, TokenName, Value) LibPcdSetEx8 ((Guid), _PCD_TOKEN_##TokenName, (Value))
|
|
|
|
|
|
/**
|
|
Sets a 16-bit PCD token value based on a GUID and a token name.
|
|
|
|
Sets the 16-bit value for the token specified by Guid and TokenName. Value is returned.
|
|
If TokenName is not a valid token in the token space specified by Guid,
|
|
then the module will not build.
|
|
|
|
If Guid is NULL, then ASSERT().
|
|
|
|
@param Guid Pointer to a 128-bit unique value that designates
|
|
which namespace to retrieve a value from.
|
|
@param TokenName The name of the PCD token to set the current value for.
|
|
@param Value The 16-bit value to set.
|
|
|
|
@return Return the Value that was set.
|
|
|
|
**/
|
|
#define PcdSetEx16(Guid, TokenName, Value) LibPcdSetEx16 ((Guid), _PCD_TOKEN_##TokenName, (Value))
|
|
|
|
|
|
/**
|
|
Sets a 32-bit PCD token value based on a GUID and a token name.
|
|
|
|
Sets the 32-bit value for the token specified by Guid and TokenName. Value is returned.
|
|
If TokenName is not a valid token in the token space specified by Guid,
|
|
then the module will not build.
|
|
|
|
If Guid is NULL, then ASSERT().
|
|
|
|
@param Guid Pointer to a 128-bit unique value that designates
|
|
which namespace to retrieve a value from.
|
|
@param TokenName The name of the PCD token to set the current value for.
|
|
@param Value The 32-bit value to set.
|
|
|
|
@return Return the Value that was set.
|
|
|
|
**/
|
|
#define PcdSetEx32(Guid, TokenName, Value) LibPcdSetEx32 ((Guid), _PCD_TOKEN_##TokenName, (Value))
|
|
|
|
|
|
/**
|
|
Sets a 64-bit PCD token value based on a GUID and a token name.
|
|
|
|
Sets the 64-bit value for the token specified by Guid and TokenName. Value is returned.
|
|
If TokenName is not a valid token in the token space specified by Guid,
|
|
then the module will not build.
|
|
|
|
If Guid is NULL, then ASSERT().
|
|
|
|
@param Guid Pointer to a 128-bit unique value that designates
|
|
which namespace to retrieve a value from.
|
|
@param TokenName The name of the PCD token to set the current value for.
|
|
@param Value The 64-bit value to set.
|
|
|
|
@return Return the Value that was set.
|
|
|
|
**/
|
|
#define PcdSetEx64(Guid, TokenName, Value) LibPcdSetEx64 ((Guid), _PCD_TOKEN_##TokenName, (Value))
|
|
|
|
|
|
/**
|
|
Sets a pointer to a PCD token buffer based on a GUID and a token name.
|
|
|
|
Sets the buffer for the token specified by Guid and TokenName. Buffer is returned.
|
|
If SizeOfBuffer is greater than the maximum size supported by Guid and TokenName,
|
|
then set SizeOfBuffer to the maximum size supported by Guid and TokenName and return
|
|
NULL to indicate that the set operation was not actually performed. If SizeOfBuffer
|
|
is set to MAX_ADDRESS, then SizeOfBuffer must be set to the maximum size supported by
|
|
Guid and TokenName and NULL must be returned.
|
|
If TokenName is not a valid token in the token space specified by Guid,
|
|
then the module will not build.
|
|
|
|
If Guid is NULL, then ASSERT().
|
|
If SizeOfBuffer is NULL, then ASSERT().
|
|
If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().
|
|
|
|
@param Guid Pointer to a 128-bit unique value that designates
|
|
which namespace to retrieve a value from.
|
|
@param TokenName The name of the PCD token to set the current value for.
|
|
@param SizeOfBuffer A pointer to the size, in bytes, of Buffer.
|
|
@param Buffer Pointer to the buffer to set.
|
|
|
|
@return Return the pointer to the Buffer that was set.
|
|
|
|
**/
|
|
#define PcdSetExPtr(Guid, TokenName, SizeOfBuffer, Buffer) \
|
|
LibPcdSetExPtr ((Guid), _PCD_TOKEN_##TokenName, (SizeOfBuffer), (Buffer))
|
|
|
|
|
|
/**
|
|
Sets a Boolean PCD token value based on a GUID and a token name.
|
|
|
|
Sets the Boolean value for the token specified by Guid and TokenName. Value is returned.
|
|
If TokenName is not a valid token in the token space specified by Guid,
|
|
then the module will not build.
|
|
|
|
If Guid is NULL, then ASSERT().
|
|
|
|
@param Guid Pointer to a 128-bit unique value that designates
|
|
which namespace to retrieve a value from.
|
|
@param TokenName The name of the PCD token to set the current value for.
|
|
@param Value The Boolean value to set.
|
|
|
|
@return Return the Value that was set.
|
|
|
|
**/
|
|
#define PcdSetExBool(Guid, TokenName, Value) \
|
|
LibPcdSetExBool((Guid), _PCD_TOKEN_##TokenName, (Value))
|
|
|
|
|
|
/**
|
|
This function provides a means by which SKU support can be established in the PCD infrastructure.
|
|
|
|
Sets the current SKU in the PCD database to the value specified by SkuId. SkuId is returned.
|
|
If SkuId >= PCD_MAX_SKU_ID, then ASSERT().
|
|
|
|
@param SkuId The SKU value that will be used when the PCD service retrieves and sets values
|
|
associated with a PCD token.
|
|
|
|
@return Return the SKU ID that was set.
|
|
|
|
**/
|
|
UINTN
|
|
EFIAPI
|
|
LibPcdSetSku (
|
|
IN UINTN SkuId
|
|
);
|
|
|
|
|
|
/**
|
|
This function provides a means by which to retrieve a value for a given PCD token.
|
|
|
|
Returns the 8-bit value for the token specified by TokenNumber.
|
|
|
|
@param[in] TokenNumber The PCD token number to retrieve a current value for.
|
|
|
|
@return Returns the 8-bit value for the token specified by TokenNumber.
|
|
|
|
**/
|
|
UINT8
|
|
EFIAPI
|
|
LibPcdGet8 (
|
|
IN UINTN TokenNumber
|
|
);
|
|
|
|
|
|
/**
|
|
This function provides a means by which to retrieve a value for a given PCD token.
|
|
|
|
Returns the 16-bit value for the token specified by TokenNumber.
|
|
|
|
@param[in] TokenNumber The PCD token number to retrieve a current value for.
|
|
|
|
@return Returns the 16-bit value for the token specified by TokenNumber.
|
|
|
|
**/
|
|
UINT16
|
|
EFIAPI
|
|
LibPcdGet16 (
|
|
IN UINTN TokenNumber
|
|
);
|
|
|
|
|
|
/**
|
|
This function provides a means by which to retrieve a value for a given PCD token.
|
|
|
|
Returns the 32-bit value for the token specified by TokenNumber.
|
|
|
|
@param[in] TokenNumber The PCD token number to retrieve a current value for.
|
|
|
|
@return Returns the 32-bit value for the token specified by TokenNumber.
|
|
|
|
**/
|
|
UINT32
|
|
EFIAPI
|
|
LibPcdGet32 (
|
|
IN UINTN TokenNumber
|
|
);
|
|
|
|
|
|
/**
|
|
This function provides a means by which to retrieve a value for a given PCD token.
|
|
|
|
Returns the 64-bit value for the token specified by TokenNumber.
|
|
|
|
@param[in] TokenNumber The PCD token number to retrieve a current value for.
|
|
|
|
@return Returns the 64-bit value for the token specified by TokenNumber.
|
|
|
|
**/
|
|
UINT64
|
|
EFIAPI
|
|
LibPcdGet64 (
|
|
IN UINTN TokenNumber
|
|
);
|
|
|
|
|
|
/**
|
|
This function provides a means by which to retrieve a value for a given PCD token.
|
|
|
|
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.
|
|
|
|
@return Returns the pointer to the token specified by TokenNumber.
|
|
|
|
**/
|
|
VOID *
|
|
EFIAPI
|
|
LibPcdGetPtr (
|
|
IN UINTN TokenNumber
|
|
);
|
|
|
|
|
|
/**
|
|
This function provides a means by which to retrieve a value for a given PCD token.
|
|
|
|
Returns the Boolean value of the token specified by TokenNumber.
|
|
|
|
@param[in] TokenNumber The PCD token number to retrieve a current value for.
|
|
|
|
@return Returns the Boolean value of the token specified by TokenNumber.
|
|
|
|
**/
|
|
BOOLEAN
|
|
EFIAPI
|
|
LibPcdGetBool (
|
|
IN UINTN TokenNumber
|
|
);
|
|
|
|
|
|
/**
|
|
This function provides a means by which to retrieve the size of a given PCD token.
|
|
|
|
@param[in] TokenNumber The PCD token number to retrieve a current value for.
|
|
|
|
@return Returns the size of the token specified by TokenNumber.
|
|
|
|
**/
|
|
UINTN
|
|
EFIAPI
|
|
LibPcdGetSize (
|
|
IN UINTN TokenNumber
|
|
);
|
|
|
|
|
|
/**
|
|
This function provides a means by which to retrieve a value for a given PCD token.
|
|
|
|
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.
|
|
|
|
@return Return the UINT8.
|
|
|
|
**/
|
|
UINT8
|
|
EFIAPI
|
|
LibPcdGetEx8 (
|
|
IN CONST GUID *Guid,
|
|
IN UINTN TokenNumber
|
|
);
|
|
|
|
|
|
/**
|
|
This function provides a means by which to retrieve a value for a given PCD token.
|
|
|
|
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.
|
|
|
|
@return Return the UINT16.
|
|
|
|
**/
|
|
UINT16
|
|
EFIAPI
|
|
LibPcdGetEx16 (
|
|
IN CONST GUID *Guid,
|
|
IN UINTN TokenNumber
|
|
);
|
|
|
|
|
|
/**
|
|
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.
|
|
|
|
@return Return the UINT32.
|
|
|
|
**/
|
|
UINT32
|
|
EFIAPI
|
|
LibPcdGetEx32 (
|
|
IN CONST GUID *Guid,
|
|
IN UINTN TokenNumber
|
|
);
|
|
|
|
|
|
/**
|
|
This function provides a means by which to retrieve a value for a given PCD token.
|
|
|
|
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.
|
|
|
|
@return Return the UINT64.
|
|
|
|
**/
|
|
UINT64
|
|
EFIAPI
|
|
LibPcdGetEx64 (
|
|
IN CONST GUID *Guid,
|
|
IN UINTN TokenNumber
|
|
);
|
|
|
|
|
|
/**
|
|
This function provides a means by which to retrieve a value for a given PCD token.
|
|
|
|
Returns the pointer to the buffer of 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.
|
|
|
|
@return Return the VOID* pointer.
|
|
|
|
**/
|
|
VOID *
|
|
EFIAPI
|
|
LibPcdGetExPtr (
|
|
IN CONST GUID *Guid,
|
|
IN UINTN TokenNumber
|
|
);
|
|
|
|
|
|
/**
|
|
This function provides a means by which to retrieve a value for a given PCD token.
|
|
|
|
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.
|
|
|
|
@return Return the BOOLEAN.
|
|
|
|
**/
|
|
BOOLEAN
|
|
EFIAPI
|
|
LibPcdGetExBool (
|
|
IN CONST GUID *Guid,
|
|
IN UINTN TokenNumber
|
|
);
|
|
|
|
|
|
/**
|
|
This function provides a means by which to retrieve the size of a given PCD token.
|
|
|
|
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.
|
|
|
|
@return Return the size.
|
|
|
|
**/
|
|
UINTN
|
|
EFIAPI
|
|
LibPcdGetExSize (
|
|
IN CONST GUID *Guid,
|
|
IN UINTN TokenNumber
|
|
);
|
|
|
|
|
|
/**
|
|
This function provides a means by which to set a value for a given PCD token.
|
|
|
|
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.
|
|
|
|
@return Return the Value that was set.
|
|
|
|
**/
|
|
UINT8
|
|
EFIAPI
|
|
LibPcdSet8 (
|
|
IN UINTN TokenNumber,
|
|
IN UINT8 Value
|
|
);
|
|
|
|
|
|
/**
|
|
This function provides a means by which to set a value for a given PCD token.
|
|
|
|
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.
|
|
|
|
@return Return the Value that was set.
|
|
|
|
**/
|
|
UINT16
|
|
EFIAPI
|
|
LibPcdSet16 (
|
|
IN UINTN TokenNumber,
|
|
IN UINT16 Value
|
|
);
|
|
|
|
|
|
/**
|
|
This function provides a means by which to set a value for a given PCD token.
|
|
|
|
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.
|
|
|
|
@return Return the Value that was set.
|
|
|
|
**/
|
|
UINT32
|
|
EFIAPI
|
|
LibPcdSet32 (
|
|
IN UINTN TokenNumber,
|
|
IN UINT32 Value
|
|
);
|
|
|
|
|
|
/**
|
|
This function provides a means by which to set a value for a given PCD token.
|
|
|
|
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.
|
|
|
|
@return Return the Value that was set.
|
|
|
|
**/
|
|
UINT64
|
|
EFIAPI
|
|
LibPcdSet64 (
|
|
IN UINTN TokenNumber,
|
|
IN UINT64 Value
|
|
);
|
|
|
|
|
|
/**
|
|
This function provides a means by which to set a value for a given PCD token.
|
|
|
|
Sets a buffer for the token specified by TokenNumber to the value
|
|
specified by Buffer and SizeOfBuffer. Buffer is returned.
|
|
If SizeOfBuffer is greater than the maximum size support by TokenNumber,
|
|
then set SizeOfBuffer to the maximum size supported by TokenNumber and
|
|
return NULL to indicate that the set operation was not actually performed.
|
|
|
|
If SizeOfBuffer is set to MAX_ADDRESS, then SizeOfBuffer must be set to the
|
|
maximum size supported by TokenName and NULL must be returned.
|
|
|
|
If SizeOfBuffer is NULL, then ASSERT().
|
|
If SizeOfBuffer > 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] Buffer A pointer to the buffer to set.
|
|
|
|
@return Return the pointer for the Buffer that was set.
|
|
|
|
**/
|
|
VOID *
|
|
EFIAPI
|
|
LibPcdSetPtr (
|
|
IN UINTN TokenNumber,
|
|
IN OUT UINTN *SizeOfBuffer,
|
|
IN CONST VOID *Buffer
|
|
);
|
|
|
|
|
|
/**
|
|
This function provides a means by which to set a value for a given PCD token.
|
|
|
|
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.
|
|
|
|
@return Return the Value that was set.
|
|
|
|
**/
|
|
BOOLEAN
|
|
EFIAPI
|
|
LibPcdSetBool (
|
|
IN UINTN TokenNumber,
|
|
IN BOOLEAN Value
|
|
);
|
|
|
|
|
|
/**
|
|
This function provides a means by which to set a value for a given PCD token.
|
|
|
|
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.
|
|
|
|
@return Return the Value that was set.
|
|
|
|
**/
|
|
UINT8
|
|
EFIAPI
|
|
LibPcdSetEx8 (
|
|
IN CONST GUID *Guid,
|
|
IN UINTN TokenNumber,
|
|
IN UINT8 Value
|
|
);
|
|
|
|
|
|
/**
|
|
This function provides a means by which to set a value for a given PCD token.
|
|
|
|
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.
|
|
|
|
@return Return the Value that was set.
|
|
|
|
**/
|
|
UINT16
|
|
EFIAPI
|
|
LibPcdSetEx16 (
|
|
IN CONST GUID *Guid,
|
|
IN UINTN TokenNumber,
|
|
IN UINT16 Value
|
|
);
|
|
|
|
|
|
/**
|
|
This function provides a means by which to set a value for a given PCD token.
|
|
|
|
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.
|
|
|
|
@return Return the Value that was set.
|
|
|
|
**/
|
|
UINT32
|
|
EFIAPI
|
|
LibPcdSetEx32 (
|
|
IN CONST GUID *Guid,
|
|
IN UINTN TokenNumber,
|
|
IN UINT32 Value
|
|
);
|
|
|
|
|
|
/**
|
|
This function provides a means by which to set a value for a given PCD token.
|
|
|
|
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.
|
|
|
|
@return Return the Value that was set.
|
|
|
|
**/
|
|
UINT64
|
|
EFIAPI
|
|
LibPcdSetEx64 (
|
|
IN CONST GUID *Guid,
|
|
IN UINTN TokenNumber,
|
|
IN UINT64 Value
|
|
);
|
|
|
|
|
|
/**
|
|
This function provides a means by which to set a value for a given PCD token.
|
|
|
|
Sets a buffer for the token specified by TokenNumber to the value specified by
|
|
Buffer and SizeOfBuffer. Buffer is returned. If SizeOfBuffer is greater than
|
|
the maximum size support by TokenNumber, then set SizeOfBuffer to the maximum size
|
|
supported by TokenNumber and return NULL to indicate that the set operation
|
|
was not actually performed.
|
|
|
|
If Guid is NULL, then ASSERT().
|
|
If SizeOfBuffer is NULL, then ASSERT().
|
|
If SizeOfBuffer > 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.
|
|
|
|
@return Return the pointer to the Buffer that was set.
|
|
|
|
**/
|
|
VOID *
|
|
EFIAPI
|
|
LibPcdSetExPtr (
|
|
IN CONST GUID *Guid,
|
|
IN UINTN TokenNumber,
|
|
IN OUT UINTN *SizeOfBuffer,
|
|
IN VOID *Buffer
|
|
);
|
|
|
|
|
|
/**
|
|
This function provides a means by which to set a value for a given PCD token.
|
|
|
|
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.
|
|
|
|
@return Return the Value that was set.
|
|
|
|
**/
|
|
BOOLEAN
|
|
EFIAPI
|
|
LibPcdSetExBool (
|
|
IN CONST GUID *Guid,
|
|
IN UINTN TokenNumber,
|
|
IN BOOLEAN Value
|
|
);
|
|
|
|
|
|
/**
|
|
This notification function serves two purposes.
|
|
|
|
Firstly, it notifies the module that did the registration that the value of this
|
|
PCD token has been set.
|
|
Secondly, it provides a mechanism for the module that did the registration to intercept
|
|
the set operation and override the value been set if necessary. After the invocation of
|
|
the callback function, TokenData will be used by PCD service PEIM or driver to modify th
|
|
internal data in PCD database.
|
|
|
|
@param[in] CallBackGuid The PCD token GUID being set.
|
|
@param[in] CallBackToken The PCD token number being set.
|
|
@param[in, out] TokenData A pointer to the token data being set.
|
|
@param[in] TokenDataSize The size, in bytes, of the data being set.
|
|
|
|
**/
|
|
typedef
|
|
VOID
|
|
(EFIAPI *PCD_CALLBACK)(
|
|
IN CONST GUID *CallBackGuid, OPTIONAL
|
|
IN UINTN CallBackToken,
|
|
IN OUT VOID *TokenData,
|
|
IN UINTN TokenDataSize
|
|
);
|
|
|
|
|
|
/**
|
|
Set up a notification function that is called when a specified token is set.
|
|
|
|
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.
|
|
|
|
**/
|
|
VOID
|
|
EFIAPI
|
|
LibPcdCallbackOnSet (
|
|
IN CONST GUID *Guid, OPTIONAL
|
|
IN UINTN TokenNumber,
|
|
IN PCD_CALLBACK NotificationFunction
|
|
);
|
|
|
|
|
|
/**
|
|
Disable a notification function that was established with LibPcdCallbackonSet().
|
|
|
|
Disable a notification function that was previously established with LibPcdCallbackOnSet().
|
|
If NotificationFunction is NULL, then ASSERT().
|
|
If LibPcdCallbackOnSet() was not previously called with Guid, TokenNumber,
|
|
and NotificationFunction, 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.
|
|
|
|
**/
|
|
VOID
|
|
EFIAPI
|
|
LibPcdCancelCallback (
|
|
IN CONST GUID *Guid, OPTIONAL
|
|
IN UINTN TokenNumber,
|
|
IN PCD_CALLBACK NotificationFunction
|
|
);
|
|
|
|
|
|
/**
|
|
Retrieves the next token in a token space.
|
|
|
|
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] 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 previous PCD token number. If 0, then retrieves the first PCD
|
|
token number.
|
|
|
|
@return The next valid token number.
|
|
|
|
**/
|
|
UINTN
|
|
EFIAPI
|
|
LibPcdGetNextToken (
|
|
IN CONST GUID *Guid, OPTIONAL
|
|
IN UINTN TokenNumber
|
|
);
|
|
|
|
|
|
|
|
/**
|
|
Used to retrieve the list of available PCD token space GUIDs.
|
|
|
|
Returns the PCD token space GUID that follows TokenSpaceGuid in the list of token spaces
|
|
in the platform.
|
|
If TokenSpaceGuid is NULL, then a pointer to the first PCD token spaces returned.
|
|
If TokenSpaceGuid is the last PCD token space GUID in the list, then NULL is returned.
|
|
|
|
@param TokenSpaceGuid Pointer to the a PCD token space GUID
|
|
|
|
@return The next valid token namespace.
|
|
|
|
**/
|
|
GUID *
|
|
EFIAPI
|
|
LibPcdGetNextTokenSpace (
|
|
IN CONST GUID *TokenSpaceGuid
|
|
);
|
|
|
|
|
|
/**
|
|
Sets a value of a patchable PCD entry that is type pointer.
|
|
|
|
Sets the PCD entry specified by PatchVariable to the value specified by Buffer
|
|
and SizeOfBuffer. Buffer is returned. If SizeOfBuffer is greater than
|
|
MaximumDatumSize, then set SizeOfBuffer to MaximumDatumSize and return
|
|
NULL to indicate that the set operation was not actually performed.
|
|
If SizeOfBuffer is set to MAX_ADDRESS, then SizeOfBuffer must be set to
|
|
MaximumDatumSize and NULL must be returned.
|
|
|
|
If PatchVariable is NULL, then ASSERT().
|
|
If SizeOfBuffer is NULL, then ASSERT().
|
|
If SizeOfBuffer > 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.
|
|
|
|
@return Return the pointer to the Buffer that was set.
|
|
|
|
**/
|
|
VOID *
|
|
EFIAPI
|
|
LibPatchPcdSetPtr (
|
|
IN VOID *PatchVariable,
|
|
IN UINTN MaximumDatumSize,
|
|
IN OUT UINTN *SizeOfBuffer,
|
|
IN CONST VOID *Buffer
|
|
);
|
|
|
|
#endif
|