mirror of https://github.com/acidanthera/audk.git
57 lines
1.9 KiB
C
57 lines
1.9 KiB
C
/** @file
|
|
Switch Stack functions.
|
|
|
|
Copyright (c) 2006, Intel Corporation<BR>
|
|
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.
|
|
|
|
Module Name: SwitchStack.c
|
|
|
|
**/
|
|
|
|
#include <BaseLibInternals.h>
|
|
|
|
/**
|
|
Transfers control to a function starting with a new stack.
|
|
|
|
Transfers control to the function specified by EntryPoint using the new stack
|
|
specified by NewStack and passing in the parameters specified by Context1 and
|
|
Context2. Context1 and Context2 are optional and may be NULL. The function
|
|
EntryPoint must never return.
|
|
|
|
If EntryPoint is NULL, then ASSERT().
|
|
If NewStack is NULL, then ASSERT().
|
|
For IPF CPUs, if NewStack is not aligned on a 16-byte boundary, then ASSERT().
|
|
|
|
@param EntryPoint A pointer to function to call with the new stack.
|
|
@param Context1 A pointer to the context to pass into the EntryPoint
|
|
function.
|
|
@param Context2 A pointer to the context to pass into the EntryPoint
|
|
function.
|
|
@param NewStack A pointer to the new stack to use for the EntryPoint
|
|
function.
|
|
|
|
**/
|
|
VOID
|
|
EFIAPI
|
|
SwitchStack (
|
|
IN SWITCH_STACK_ENTRY_POINT EntryPoint,
|
|
IN VOID *Context1,
|
|
IN VOID *Context2,
|
|
IN VOID *NewStack
|
|
)
|
|
{
|
|
ASSERT (EntryPoint != NULL && NewStack != NULL);
|
|
|
|
#ifdef MDE_CPU_IPF
|
|
ASSERT (((UINTN)NewStack & 0xf) == 0);
|
|
#endif
|
|
|
|
InternalSwitchStack (EntryPoint, Context1, Context2, NewStack);
|
|
}
|