REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3737 Apply uncrustify changes to .c/.h files in the MdePkg package Cc: Andrew Fish <afish@apple.com> Cc: Leif Lindholm <leif@nuviainc.com> Cc: Michael D Kinney <michael.d.kinney@intel.com> Signed-off-by: Michael Kubacki <michael.kubacki@microsoft.com> Reviewed-by: Liming Gao <gaoliming@byosoft.com.cn>
		
			
				
	
	
		
			58 lines
		
	
	
		
			2.3 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			58 lines
		
	
	
		
			2.3 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| /** @file
 | |
|   IA-32/x64 AsmDisablePaging32()
 | |
| 
 | |
|   Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>
 | |
|   SPDX-License-Identifier: BSD-2-Clause-Patent
 | |
| 
 | |
| **/
 | |
| 
 | |
| #include "BaseLibInternals.h"
 | |
| 
 | |
| /**
 | |
|   Disables the 32-bit paging mode on the CPU.
 | |
| 
 | |
|   Disables the 32-bit paging mode on the CPU and returns to 32-bit protected
 | |
|   mode. This function assumes the current execution mode is 32-paged protected
 | |
|   mode. This function is only available on IA-32. After the 32-bit paging mode
 | |
|   is disabled, control is transferred 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 the current execution mode is not 32-bit paged mode, then ASSERT().
 | |
|   If EntryPoint is NULL, then ASSERT().
 | |
|   If NewStack is NULL, then ASSERT().
 | |
| 
 | |
|   There are a number of constraints that must be followed before calling this
 | |
|   function:
 | |
|   1)  Interrupts must be disabled.
 | |
|   2)  The caller must be in 32-bit paged mode.
 | |
|   3)  CR0, CR3, and CR4 must be compatible with 32-bit paged mode.
 | |
|   4)  CR3 must point to valid page tables that guarantee that the pages for
 | |
|       this function and the stack are identity mapped.
 | |
| 
 | |
|   @param  EntryPoint  A pointer to function to call with the new stack after
 | |
|                       paging is disabled.
 | |
|   @param  Context1    A pointer to the context to pass into the EntryPoint
 | |
|                       function as the first parameter after paging is disabled.
 | |
|   @param  Context2    A pointer to the context to pass into the EntryPoint
 | |
|                       function as the second parameter after paging is
 | |
|                       disabled.
 | |
|   @param  NewStack    A pointer to the new stack to use for the EntryPoint
 | |
|                       function after paging is disabled.
 | |
| 
 | |
| **/
 | |
| VOID
 | |
| EFIAPI
 | |
| AsmDisablePaging32 (
 | |
|   IN      SWITCH_STACK_ENTRY_POINT  EntryPoint,
 | |
|   IN      VOID                      *Context1   OPTIONAL,
 | |
|   IN      VOID                      *Context2   OPTIONAL,
 | |
|   IN      VOID                      *NewStack
 | |
|   )
 | |
| {
 | |
|   ASSERT (EntryPoint != NULL);
 | |
|   ASSERT (NewStack != NULL);
 | |
|   InternalX86DisablePaging32 (EntryPoint, Context1, Context2, NewStack);
 | |
| }
 |