esalruntimelib.h

来自「EFI BIOS是Intel提出的下一代的BIOS标准。这里上传的Edk源代码是」· C头文件 代码 · 共 1,306 行 · 第 1/2 页

/*++

Copyright (c) 2004, 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.             

Module Name:

  EsalRuntimeLib.h
  
Abstract:

  SAL Driver Lib

Revision History

--*/

#ifndef _ESAL_RUNTIME_LIB_H_
#define _ESAL_RUNTIME_LIB_H_

#include "SalApi.h"
#include "EfiFirmwareVolumeHeader.h"

#include EFI_PROTOCOL_DEFINITION (ExtendedSalBootService)
#include EFI_PROTOCOL_DEFINITION (ExtendedSalGuid)
#include EFI_PROTOCOL_DEFINITION (FirmwareVolumeBlock)

VOID
EsalRuntimeLibVirtualNotify (
  VOID
  )
/*++

Routine Description:

  TODO: Add function description

Arguments:

  None

Returns:

  TODO: add return values

--*/
;

EFI_STATUS
EsalInitializeRuntimeDriverLib (
  IN EFI_HANDLE           ImageHandle,
  IN EFI_SYSTEM_TABLE     *SystemTable
  )
/*++

Routine Description:

  TODO: Add function description

Arguments:

  ImageHandle - Image Handle
  SystemTable - the System Table 

Returns:

  TODO: add return values

--*/
;
SAL_RETURN_REGS
CallEsalService (
  IN  EFI_GUID                                       *ClassGuid,
  IN   UINT64                                        FunctionId,
  IN  UINT64                                         Arg2,
  IN  UINT64                                         Arg3,
  IN  UINT64                                         Arg4,
  IN  UINT64                                         Arg5,
  IN  UINT64                                         Arg6,
  IN  UINT64                                         Arg7,
  IN  UINT64                                         Arg8
  )
/*++

Routine Description:

  TODO: Add function description

Arguments:

  ClassGuid   - TODO: add argument description
  FunctionId  - TODO: add argument description
  Arg2        - TODO: add argument description
  Arg3        - TODO: add argument description
  Arg4        - TODO: add argument description
  Arg5        - TODO: add argument description
  Arg6        - TODO: add argument description
  Arg7        - TODO: add argument description
  Arg8        - TODO: add argument description

Returns:

  TODO: add return values

--*/
;

//
//  Assembly Functions
//

SAL_RETURN_REGS
EsalGetEntryPoint (
  VOID
  )
/*++

Routine Description:

  TODO: Add function description

Arguments:

  None

Returns:

  TODO: add return values

--*/
;

SAL_RETURN_REGS
EsalSetPhysicalEntryPoint (
  IN  UINT64  EntryPoint,
  IN  UINT64  Gp
  )
/*++

Routine Description:

  TODO: Add function description

Arguments:

  EntryPoint  - TODO: add argument description
  Gp          - TODO: add argument description

Returns:

  TODO: add return values

--*/
;

SAL_RETURN_REGS
EsalSetVirtualEntryPoint (
  IN  UINT64  EntryPoint,
  IN  UINT64  Gp
  )
/*++

Routine Description:

  TODO: Add function description

Arguments:

  EntryPoint  - TODO: add argument description
  Gp          - TODO: add argument description

Returns:

  TODO: add return values

--*/
;

SAL_RETURN_REGS
EsalSetPhysicalModuleGlobal (
  IN  VOID    *Global
  )
/*++

Routine Description:

  TODO: Add function description

Arguments:

  Global  - TODO: add argument description

Returns:

  TODO: add return values

--*/
;

SAL_RETURN_REGS
EsalSetVirtualModuleGlobal (
  IN  VOID    *Global
  )
/*++

Routine Description:

  TODO: Add function description

Arguments:

  Global  - TODO: add argument description

Returns:

  TODO: add return values

--*/
;

SAL_RETURN_REGS
EsalGetModuleGlobal (
  VOID
  )
/*++

Routine Description:

  TODO: Add function description

Arguments:

  None

Returns:

  TODO: add return values

--*/
;

SAL_RETURN_REGS
GetIrrData (
  VOID
  )
/*++

Routine Description:

  TODO: Add function description

Arguments:

  None

Returns:

  TODO: add return values

--*/
;

SAL_RETURN_REGS
GetPsrData (
  VOID
  )
/*++

Routine Description:

  TODO: Add function description

Arguments:

  None

Returns:

  TODO: add return values

--*/
;

SAL_RETURN_REGS
GetProcIdData (
  VOID
  )
/*++

Routine Description:

  TODO: Add function description

Arguments:

  None

Returns:

  TODO: add return values

--*/
;

VOID
SwitchCpuStack (
  IN  UINT64  NewBsp,
  IN  UINT64  OldBsp
  )
/*++

Routine Description:

  TODO: Add function description

Arguments:

  NewBsp  - TODO: add argument description
  OldBsp  - TODO: add argument description

Returns:

  TODO: add return values

--*/
;

//
//  PAL PROC Class
//

SAL_RETURN_REGS
SalPalProc (
  IN  UINT64            Arg1,
  IN  UINT64            Arg2,
  IN  UINT64            Arg3,
  IN  UINT64            Arg4
  )
/*++

Routine Description:

  TODO: Add function description

Arguments:

  Arg1  - TODO: add argument description
  Arg2  - TODO: add argument description
  Arg3  - TODO: add argument description
  Arg4  - TODO: add argument description

Returns:

  TODO: add return values

--*/
;

SAL_RETURN_REGS
SalRegisterNewPalEntry (
  IN  BOOLEAN                     PhysicalPalAddress,
  IN  EFI_PHYSICAL_ADDRESS        NewPalAddress
  )
/*++

Routine Description:

  TODO: Add function description

Arguments:

  PhysicalPalAddress  - TODO: add argument description
  NewPalAddress       - TODO: add argument description

Returns:

  TODO: add return values

--*/
;

SAL_RETURN_REGS
SalGetPalEntryPointer (
  IN  BOOLEAN                     PhysicalPalAddress
  )
/*++

Routine Description:

  TODO: Add function description

Arguments:

  PhysicalPalAddress  - TODO: add argument description

Returns:

  TODO: add return values

--*/
;

//
//  SAL BASE Class
//

SAL_RETURN_REGS
SalProcSetVectors (
  IN  UINT64                      SalVectorType,
  IN  UINT64                      PhyAddr1,
  IN  UINT64                      Gp1,
  IN  UINT64                      LengthCs1,
  IN  UINT64                      PhyAddr2,
  IN  UINT64                      Gp2,
  IN  UINT64                      LengthCs2
  )
/*++

Routine Description:

  TODO: Add function description

Arguments:

  SalVectorType - TODO: add argument description
  PhyAddr1      - TODO: add argument description
  Gp1           - TODO: add argument description
  LengthCs1     - TODO: add argument description
  PhyAddr2      - TODO: add argument description
  Gp2           - TODO: add argument description
  LengthCs2     - TODO: add argument description

Returns:

  TODO: add return values

--*/
;

SAL_RETURN_REGS
SalProcMcRendez (
  VOID
  )
/*++

Routine Description:

  TODO: Add function description

Arguments:

  None

Returns:

  TODO: add return values

--*/
;

SAL_RETURN_REGS
SalProcMcSetParams (
  IN  UINT64                      ParamType,
  IN  UINT64                      IntOrMem,
  IN  UINT64                      IntOrMemVal,
  IN  UINT64                      Timeout,
  IN  UINT64                      McaOpt
  )
/*++

Routine Description:

  TODO: Add function description

Arguments:

  ParamType   - TODO: add argument description
  IntOrMem    - TODO: add argument description
  IntOrMemVal - TODO: add argument description
  Timeout     - TODO: add argument description
  McaOpt      - TODO: add argument description

Returns:

  TODO: add return values

--*/
;

SAL_RETURN_REGS
EsalProcGetVectors (
  IN  UINT64                      VectorType
  )
/*++

Routine Description:

  TODO: Add function description

Arguments:

  VectorType  - TODO: add argument description

Returns:

  TODO: add return values

--*/
;

SAL_RETURN_REGS
EsalProcMcGetParams (
  IN  UINT64                      ParamInfoType
  )
/*++

Routine Description:

  TODO: Add function description

Arguments:

  ParamInfoType - TODO: add argument description

Returns:

  TODO: add return values

--*/
;

SAL_RETURN_REGS
EsalProcMcGetMcParams (
  VOID
  )
/*++

Routine Description:

  TODO: Add function description

Arguments:

  None

Returns:

  TODO: add return values

--*/
;

SAL_RETURN_REGS
EsalProcGetMcCheckinFlags (
  IN  UINT64                      ProcessorUnit
  )
/*++

Routine Description:

  TODO: Add function description

Arguments:

  ProcessorUnit - TODO: add argument description

Returns:

  TODO: add return values

--*/
;

//
//  Sal Base Class enums
//

typedef enum {
  McaVector,
  BspInitVector,
  BootRendezVector,
  ApInitVector
} ESAL_GET_VECTOR_TYPE;

SAL_RETURN_REGS
SalInitializeThreshold (
  IN  VOID                        *ThresholdStruct,
  IN  UINT64                      Count,
  IN  UINT64                      Duration
  )
/*++

Routine Description:

  TODO: Add function description

Arguments:

  ThresholdStruct - TODO: add argument description
  Count           - TODO: add argument description
  Duration        - TODO: add argument description

Returns:

  TODO: add return values

--*/
;

SAL_RETURN_REGS
SalBumpThresholdCount (
  IN  VOID                        *ThresholdStruct,
  IN  UINT64                      Count,
  IN  UINT64                      Duration
  )
/*++

Routine Description:

  TODO: Add function description

Arguments:

  ThresholdStruct - TODO: add argument description
  Count           - TODO: add argument description
  Duration        - TODO: add argument description

Returns:

  TODO: add return values

--*/
;

SAL_RETURN_REGS
SalGetThresholdCount (
  IN  VOID                        *ThresholdStruct,
  IN  UINT64                      Count,
  IN  UINT64                      Duration
  )
/*++

Routine Description:

  TODO: Add function description

Arguments: