4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/** @file
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Declaration of internal functions in BaseSynchronizationLib.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync This program and the accompanying materials
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync are licensed and made available under the terms and conditions of the BSD License
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync which accompanies this distribution. The full text of the license may be found at
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync http://opensource.org/licenses/bsd-license.php.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync**/
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#ifndef __BASE_SYNCHRONIZATION_LIB_INTERNALS__
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#define __BASE_SYNCHRONIZATION_LIB_INTERNALS__
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#include <Base.h>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#include <Library/SynchronizationLib.h>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#include <Library/BaseLib.h>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#include <Library/DebugLib.h>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#include <Library/TimerLib.h>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#include <Library/PcdLib.h>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/**
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Performs an atomic increment of an 32-bit unsigned integer.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Performs an atomic increment of the 32-bit unsigned integer specified by
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Value and returns the incremented value. The increment operation must be
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync performed using MP safe mechanisms. The state of the return value is not
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync guaranteed to be MP safe.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Value A pointer to the 32-bit value to increment.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @return The incremented value.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync**/
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncUINT32
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncEFIAPI
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncInternalSyncIncrement (
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN volatile UINT32 *Value
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync );
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/**
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Performs an atomic decrement of an 32-bit unsigned integer.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Performs an atomic decrement of the 32-bit unsigned integer specified by
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Value and returns the decrement value. The decrement operation must be
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync performed using MP safe mechanisms. The state of the return value is not
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync guaranteed to be MP safe.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Value A pointer to the 32-bit value to decrement.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @return The decrement value.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync**/
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncUINT32
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncEFIAPI
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncInternalSyncDecrement (
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN volatile UINT32 *Value
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync );
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/**
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Performs an atomic compare exchange operation on a 32-bit unsigned integer.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Performs an atomic compare exchange operation on the 32-bit unsigned integer
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync specified by Value. If Value is equal to CompareValue, then Value is set to
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ExchangeValue and CompareValue is returned. If Value is not equal to CompareValue,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync then Value is returned. The compare exchange operation must be performed using
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync MP safe mechanisms.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Value A pointer to the 32-bit value for the compare exchange
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync operation.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param CompareValue A 32-bit value used in compare operation.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param ExchangeValue A 32-bit value used in exchange operation.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @return The original *Value before exchange.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync**/
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncUINT32
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncEFIAPI
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncInternalSyncCompareExchange32 (
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN volatile UINT32 *Value,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN UINT32 CompareValue,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN UINT32 ExchangeValue
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync );
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/**
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Performs an atomic compare exchange operation on a 64-bit unsigned integer.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Performs an atomic compare exchange operation on the 64-bit unsigned integer specified
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync by Value. If Value is equal to CompareValue, then Value is set to ExchangeValue and
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync CompareValue is returned. If Value is not equal to CompareValue, then Value is returned.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync The compare exchange operation must be performed using MP safe mechanisms.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Value A pointer to the 64-bit value for the compare exchange
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync operation.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param CompareValue A 64-bit value used in compare operation.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param ExchangeValue A 64-bit value used in exchange operation.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @return The original *Value before exchange.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync**/
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncUINT64
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncEFIAPI
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncInternalSyncCompareExchange64 (
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN volatile UINT64 *Value,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN UINT64 CompareValue,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN UINT64 ExchangeValue
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync );
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#endif