MdePkg/Include/Protocol/ExtendedSalBootService.h File Reference


Data Structures

struct  _EXTENDED_SAL_BOOT_SERVICE_PROTOCOL

Defines

#define EXTENDED_SAL_BOOT_SERVICE_PROTOCOL_GUID   { 0xde0ee9a4, 0x3c7a, 0x44f2, {0xb7, 0x8b, 0xe3, 0xcc, 0xd6, 0x9c, 0x3a, 0xf7 } }

Typedefs

typedef struct
_EXTENDED_SAL_BOOT_SERVICE_PROTOCOL 
EXTENDED_SAL_BOOT_SERVICE_PROTOCOL
typedef EFI_STATUS(EFIAPI * EXTENDED_SAL_ADD_SST_INFO )(IN EXTENDED_SAL_BOOT_SERVICE_PROTOCOL *This, IN UINT16 SalAVersion, IN UINT16 SalBVersion, IN CHAR8 *OemId, IN CHAR8 *ProductId)
typedef EFI_STATUS(EFIAPI * EXTENDED_SAL_ADD_SST_ENTRY )(IN EXTENDED_SAL_BOOT_SERVICE_PROTOCOL *This, IN UINT8 *TableEntry, IN UINTN EntrySize)
typedef SAL_RETURN_REGS(EFIAPI * SAL_INTERNAL_EXTENDED_SAL_PROC )(IN UINT64 FunctionId, IN UINT64 Arg2, IN UINT64 Arg3, IN UINT64 Arg4, IN UINT64 Arg5, IN UINT64 Arg6, IN UINT64 Arg7, IN UINT64 Arg8, IN BOOLEAN VirtualMode, IN VOID *ModuleGlobal)
typedef EFI_STATUS(EFIAPI * EXTENDED_SAL_REGISTER_INTERNAL_PROC )(IN EXTENDED_SAL_BOOT_SERVICE_PROTOCOL *This, IN UINT64 ClassGuidLo, IN UINT64 ClassGuidHi, IN UINT64 FunctionId, IN SAL_INTERNAL_EXTENDED_SAL_PROC InternalSalProc, IN VOID *PhysicalModuleGlobal)
typedef SAL_RETURN_REGS(EFIAPI * EXTENDED_SAL_PROC )(IN UINT64 ClassGuidLo, IN UINT64 ClassGuidHi, IN UINT64 FunctionId, IN UINT64 Arg2, IN UINT64 Arg3, IN UINT64 Arg4, IN UINT64 Arg5, IN UINT64 Arg6, IN UINT64 Arg7, IN UINT64 Arg8)

Variables

EFI_GUID gEfiExtendedSalBootServiceProtocolGuid

Detailed Description

Definition of Extended SAL Boot Service Protocol

The Extended SAL Boot Service Protocol provides a mechanisms for platform specific drivers to update the SAL System Table and register Extended SAL Procedures that are callable in physical or virtual mode using the SAL calling convention.

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


Define Documentation

#define EXTENDED_SAL_BOOT_SERVICE_PROTOCOL_GUID   { 0xde0ee9a4, 0x3c7a, 0x44f2, {0xb7, 0x8b, 0xe3, 0xcc, 0xd6, 0x9c, 0x3a, 0xf7 } }


Typedef Documentation

typedef EFI_STATUS(EFIAPI * EXTENDED_SAL_ADD_SST_ENTRY)(IN EXTENDED_SAL_BOOT_SERVICE_PROTOCOL *This, IN UINT8 *TableEntry, IN UINTN EntrySize)

Adds an entry to the SAL System Table.

This function adds the SAL System Table Entry specified by TableEntry and EntrySize to the SAL System Table.

Parameters:
This A pointer to the EXTENDED_SAL_BOOT_SERVICE_PROTOCOL instance.
TableEntry Pointer to a buffer containing a SAL System Table entry that is EntrySize bytes in length. The first byte of the TableEntry describes the type of entry.
EntrySize The size, in bytes, of TableEntry.
Return values:
EFI_SUCCESSThe SAL System Table was updated successfully.
EFI_INVALID_PARAMETER TableEntry is NULL.
EFI_INVALID_PARAMETER TableEntry specifies an invalid entry type.
EFI_INVALID_PARAMETER EntrySize is not valid for this type of entry.

typedef EFI_STATUS(EFIAPI * EXTENDED_SAL_ADD_SST_INFO)(IN EXTENDED_SAL_BOOT_SERVICE_PROTOCOL *This, IN UINT16 SalAVersion, IN UINT16 SalBVersion, IN CHAR8 *OemId, IN CHAR8 *ProductId)

Adds platform specific information to the to the header of the SAL System Table.

Parameters:
This A pointer to the EXTENDED_SAL_BOOT_SERVICE_PROTOCOL instance.
SalAVersion Version of recovery SAL PEIM(s) in BCD format. Higher byte contains the major revision and the lower byte contains the minor revision.
SalBVersion Version of DXE SAL Driver in BCD format. Higher byte contains the major revision and the lower byte contains the minor revision.
OemId A pointer to a Null-terminated ASCII string that contains OEM unique string. The string cannot be longer than 32 bytes in total length
ProductId A pointer to a Null-terminated ASCII string that uniquely identifies a family of compatible products. The string cannot be longer than 32 bytes in total length.
Return values:
EFI_SUCCESS The SAL System Table header was updated successfully.
EFI_INVALID_PARAMETER OemId is NULL.
EFI_INVALID_PARAMETER ProductId is NULL.
EFI_INVALID_PARAMETER The length of OemId is greater than 32 characters.
EFI_INVALID_PARAMETER The length of ProductId is greater than 32 characters.

typedef SAL_RETURN_REGS(EFIAPI * EXTENDED_SAL_PROC)(IN UINT64 ClassGuidLo, IN UINT64 ClassGuidHi, IN UINT64 FunctionId, IN UINT64 Arg2, IN UINT64 Arg3, IN UINT64 Arg4, IN UINT64 Arg5, IN UINT64 Arg6, IN UINT64 Arg7, IN UINT64 Arg8)

Calls a previously registered Extended SAL Procedure.

This function calls the Extended SAL Procedure specified by ClassGuidLo, ClassGuidHi, and FunctionId. The set of previously registered Extended SAL Procedures is searched for a matching ClassGuidLo, ClassGuidHi, and FunctionId. If a match is not found, then EFI_SAL_NOT_IMPLEMENTED is returned.

Parameters:
ClassGuidLo The lower 64-bits of the class GUID for the Extended SAL Procedure that is being called.
ClassGuidHi The upper 64-bits of the class GUID for the Extended SAL Procedure that is being called.
FunctionId Function ID for the Extended SAL Procedure being called.
Arg2 Second argument to the Extended SAL procedure.
Arg3 Third argument to the Extended SAL procedure.
Arg4 Fourth argument to the Extended SAL procedure.
Arg5 Fifth argument to the Extended SAL procedure.
Arg6 Sixth argument to the Extended SAL procedure.
Arg7 Seventh argument to the Extended SAL procedure.
Arg8 Eighth argument to the Extended SAL procedure.
Return values:
EFI_SAL_NOT_IMPLEMENTED The Extended SAL Procedure specified by ClassGuidLo, ClassGuidHi, and FunctionId has not been registered.
EFI_SAL_VIRTUAL_ADDRESS_ERROR This function was called in virtual mode before virtual mappings for the specified Extended SAL Procedure are available.
Other The result returned from the specified Extended SAL Procedure

typedef EFI_STATUS(EFIAPI * EXTENDED_SAL_REGISTER_INTERNAL_PROC)(IN EXTENDED_SAL_BOOT_SERVICE_PROTOCOL *This, IN UINT64 ClassGuidLo, IN UINT64 ClassGuidHi, IN UINT64 FunctionId, IN SAL_INTERNAL_EXTENDED_SAL_PROC InternalSalProc, IN VOID *PhysicalModuleGlobal)

Registers an Extended SAL Procedure.

The Extended SAL Procedure specified by InternalSalProc and named by ClassGuidLo, ClassGuidHi, and FunctionId is added to the set of available Extended SAL Procedures.

Parameters:
This A pointer to the EXTENDED_SAL_BOOT_SERVICE_PROTOCOL instance.
ClassGuidLo The lower 64-bits of the class GUID for the Extended SAL Procedure being added. Each class GUID contains one or more functions specified by a Function ID.
ClassGuidHi The upper 64-bits of the class GUID for the Extended SAL Procedure being added. Each class GUID contains one or more functions specified by a Function ID.
FunctionId The Function ID for the Extended SAL Procedure that is being added. This Function ID is a member of the Extended SAL Procedure class specified by ClassGuidLo and ClassGuidHi.
InternalSalProc A pointer to the Extended SAL Procedure being added.
PhysicalModuleGlobal Pointer to a module global structure. This is a physical mode pointer. This pointer is passed to the Extended SAL Procedure specified by ClassGuidLo, ClassGuidHi, FunctionId, and InternalSalProc. If the system is in physical mode, then this pointer is passed unmodified to InternalSalProc. If the system is in virtual mode, then the virtual address associated with this pointer is passed to InternalSalProc.
Return values:
EFI_SUCCESS The Extended SAL Procedure was added.
EFI_OUT_OF_RESOURCES There are not enough resources available to add the Extended SAL Procedure.

typedef SAL_RETURN_REGS(EFIAPI * SAL_INTERNAL_EXTENDED_SAL_PROC)(IN UINT64 FunctionId, IN UINT64 Arg2, IN UINT64 Arg3, IN UINT64 Arg4, IN UINT64 Arg5, IN UINT64 Arg6, IN UINT64 Arg7, IN UINT64 Arg8, IN BOOLEAN VirtualMode, IN VOID *ModuleGlobal)

Internal ESAL procedures.

This is prototype of internal Extended SAL procedures, which is registerd by EXTENDED_SAL_REGISTER_INTERNAL_PROC service.

Parameters:
FunctionId The Function ID associated with this Extended SAL Procedure.
Arg2 Second argument to the Extended SAL procedure.
Arg3 Third argument to the Extended SAL procedure.
Arg4 Fourth argument to the Extended SAL procedure.
Arg5 Fifth argument to the Extended SAL procedure.
Arg6 Sixth argument to the Extended SAL procedure.
Arg7 Seventh argument to the Extended SAL procedure.
Arg8 Eighth argument to the Extended SAL procedure.
VirtualMode TRUE if the Extended SAL Procedure is being invoked in virtual mode. FALSE if the Extended SAL Procedure is being invoked in physical mode.
ModuleGlobal A pointer to the global context associated with this Extended SAL Procedure.
Returns:
The result returned from the specified Extended SAL Procedure


Variable Documentation


Generated on Wed Sep 23 16:24:23 2015 for MdePkg[ALL] by  doxygen 1.5.7.1