- Generated on Fri Nov 15 2024 18:01:35 for TianoCore EDK2 by
1.9.6
|
TianoCore EDK2 master
|
#include <Protocol/MpService.h>Go to the source code of this file.
Data Structures | |
| struct | _EFI_PEI_MP_SERVICES_PPI |
Macros | |
| #define | EFI_PEI_MP_SERVICES_PPI_GUID |
Variables | |
| EFI_GUID | gEfiPeiMpServicesPpiGuid |
This file declares UEFI PI Multi-processor PPI. This PPI is installed by some platform or chipset-specific PEIM that abstracts handling multiprocessor support.
Copyright (c) 2015 - 2017, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent
Definition in file MpServices.h.
| #define EFI_PEI_MP_SERVICES_PPI_GUID |
Definition at line 19 of file MpServices.h.
| typedef EFI_STATUS(EFIAPI * EFI_PEI_MP_SERVICES_ENABLEDISABLEAP) (IN CONST EFI_PEI_SERVICES **PeiServices, IN EFI_PEI_MP_SERVICES_PPI *This, IN UINTN ProcessorNumber, IN BOOLEAN EnableAP, IN UINT32 *HealthFlag OPTIONAL) |
Enable or disable an application processor.
| [in] | PeiServices | An indirect pointer to the PEI Services Table published by the PEI Foundation. |
| [in] | This | A pointer to the EFI_PEI_MP_SERVICES_PPI instance. |
| [in] | ProcessorNumber | The handle number of the AP. The range is from 0 to the total number of logical processors minus 1. The total number of logical processors can be retrieved by EFI_PEI_MP_SERVICES_PPI.GetNumberOfProcessors(). |
| [in] | EnableAP | Specifies the new state for the processor for enabled, FALSE for disabled. |
| [in] | HealthFlag | If not NULL, a pointer to a value that specifies the new health status of the AP. This flag corresponds to StatusFlag defined in EFI_PEI_MP_SERVICES_PPI.GetProcessorInfo(). Only the PROCESSOR_HEALTH_STATUS_BIT is used. All other bits are ignored. If it is NULL, this parameter is ignored. |
| EFI_SUCCESS | The specified AP was enabled or disabled successfully. |
| EFI_UNSUPPORTED | Enabling or disabling an AP cannot be completed prior to this service returning. |
| EFI_UNSUPPORTED | Enabling or disabling an AP is not supported. |
| EFI_DEVICE_ERROR | The calling processor is an AP. |
| EFI_NOT_FOUND | Processor with the handle specified by ProcessorNumber does not exist. |
| EFI_INVALID_PARAMETER | ProcessorNumber specifies the BSP. |
Definition at line 229 of file MpServices.h.
| typedef EFI_STATUS(EFIAPI * EFI_PEI_MP_SERVICES_GET_NUMBER_OF_PROCESSORS) (IN CONST EFI_PEI_SERVICES **PeiServices, IN EFI_PEI_MP_SERVICES_PPI *This, OUT UINTN *NumberOfProcessors, OUT UINTN *NumberOfEnabledProcessors) |
Get the number of CPU's.
| [in] | PeiServices | An indirect pointer to the PEI Services Table published by the PEI Foundation. |
| [in] | This | Pointer to this instance of the PPI. |
| [out] | NumberOfProcessors | Pointer to the total number of logical processors in the system, including the BSP and disabled APs. |
| [out] | NumberOfEnabledProcessors | Number of processors in the system that are enabled. |
| EFI_SUCCESS | The number of logical processors and enabled logical processors was retrieved. |
| EFI_DEVICE_ERROR | The calling processor is an AP. |
| EFI_INVALID_PARAMETER | NumberOfProcessors is NULL. NumberOfEnabledProcessors is NULL. |
Definition at line 44 of file MpServices.h.
| typedef EFI_STATUS(EFIAPI * EFI_PEI_MP_SERVICES_GET_PROCESSOR_INFO) (IN CONST EFI_PEI_SERVICES **PeiServices, IN EFI_PEI_MP_SERVICES_PPI *This, IN UINTN ProcessorNumber, OUT EFI_PROCESSOR_INFORMATION *ProcessorInfoBuffer) |
Get information on a specific CPU.
| [in] | PeiServices | An indirect pointer to the PEI Services Table published by the PEI Foundation. |
| [in] | This | Pointer to this instance of the PPI. |
| [in] | ProcessorNumber | Pointer to the total number of logical processors in the system, including the BSP and disabled APs. |
| [out] | ProcessorInfoBuffer | Number of processors in the system that are enabled. |
| EFI_SUCCESS | Processor information was returned. |
| EFI_DEVICE_ERROR | The calling processor is an AP. |
| EFI_INVALID_PARAMETER | ProcessorInfoBuffer is NULL. |
| EFI_NOT_FOUND | The processor with the handle specified by ProcessorNumber does not exist in the platform. |
Definition at line 69 of file MpServices.h.
| typedef struct _EFI_PEI_MP_SERVICES_PPI EFI_PEI_MP_SERVICES_PPI |
Definition at line 24 of file MpServices.h.
| typedef EFI_STATUS(EFIAPI * EFI_PEI_MP_SERVICES_STARTUP_ALL_APS) (IN CONST EFI_PEI_SERVICES **PeiServices, IN EFI_PEI_MP_SERVICES_PPI *This, IN EFI_AP_PROCEDURE Procedure, IN BOOLEAN SingleThread, IN UINTN TimeoutInMicroSeconds, IN VOID *ProcedureArgument OPTIONAL) |
Activate all of the application processors.
| [in] | PeiServices | An indirect pointer to the PEI Services Table published by the PEI Foundation. |
| [in] | This | A pointer to the EFI_PEI_MP_SERVICES_PPI instance. |
| [in] | Procedure | A pointer to the function to be run on enabled APs of the system. |
| [in] | SingleThread | If TRUE, then all the enabled APs execute the function specified by Procedure one by one, in ascending order of processor handle number. If FALSE, then all the enabled APs execute the function specified by Procedure simultaneously. |
| [in] | TimeoutInMicroSeconds | Indicates the time limit in microseconds for APs to return from Procedure, for blocking mode only. Zero means infinity. If the timeout expires before all APs return from Procedure, then Procedure on the failed APs is terminated. All enabled APs are available for next function assigned by EFI_PEI_MP_SERVICES_PPI.StartupAllAPs() or EFI_PEI_MP_SERVICES_PPI.StartupThisAP(). If the timeout expires in blocking mode, BSP returns EFI_TIMEOUT. |
| [in] | ProcedureArgument | The parameter passed into Procedure for all APs. |
| EFI_SUCCESS | In blocking mode, all APs have finished before the timeout expired. |
| EFI_DEVICE_ERROR | Caller processor is AP. |
| EFI_NOT_STARTED | No enabled APs exist in the system. |
| EFI_NOT_READY | Any enabled APs are busy. |
| EFI_TIMEOUT | In blocking mode, the timeout expired before all enabled APs have finished. |
| EFI_INVALID_PARAMETER | Procedure is NULL. |
Definition at line 112 of file MpServices.h.
| typedef EFI_STATUS(EFIAPI * EFI_PEI_MP_SERVICES_STARTUP_THIS_AP) (IN CONST EFI_PEI_SERVICES **PeiServices, IN EFI_PEI_MP_SERVICES_PPI *This, IN EFI_AP_PROCEDURE Procedure, IN UINTN ProcessorNumber, IN UINTN TimeoutInMicroseconds, IN VOID *ProcedureArgument OPTIONAL) |
Activate a specific application processor.
| [in] | PeiServices | An indirect pointer to the PEI Services Table published by the PEI Foundation. |
| [in] | This | A pointer to the EFI_PEI_MP_SERVICES_PPI instance. |
| [in] | Procedure | A pointer to the function to be run on enabled APs of the system. |
| [in] | ProcessorNumber | The handle number of the AP. The range is from 0 to the total number of logical processors minus 1. The total number of logical processors can be retrieved by EFI_PEI_MP_SERVICES_PPI.GetNumberOfProcessors(). |
| [in] | TimeoutInMicroSeconds | Indicates the time limit in microseconds for APs to return from Procedure, for blocking mode only. Zero means infinity. If the timeout expires before all APs return from Procedure, then Procedure on the failed APs is terminated. All enabled APs are available for next function assigned by EFI_PEI_MP_SERVICES_PPI.StartupAllAPs() or EFI_PEI_MP_SERVICES_PPI.StartupThisAP(). If the timeout expires in blocking mode, BSP returns EFI_TIMEOUT. |
| [in] | ProcedureArgument | The parameter passed into Procedure for all APs. |
| EFI_SUCCESS | In blocking mode, specified AP finished before the timeout expires. |
| EFI_DEVICE_ERROR | The calling processor is an AP. |
| EFI_TIMEOUT | In blocking mode, the timeout expired before the specified AP has finished. |
| EFI_NOT_FOUND | The processor with the handle specified by ProcessorNumber does not exist. |
| EFI_INVALID_PARAMETER | ProcessorNumber specifies the BSP or disabled AP. |
| EFI_INVALID_PARAMETER | Procedure is NULL. |
Definition at line 157 of file MpServices.h.
| typedef EFI_STATUS(EFIAPI * EFI_PEI_MP_SERVICES_SWITCH_BSP) (IN CONST EFI_PEI_SERVICES **PeiServices, IN EFI_PEI_MP_SERVICES_PPI *This, IN UINTN ProcessorNumber, IN BOOLEAN EnableOldBSP) |
Switch the boot strap processor.
| [in] | PeiServices | An indirect pointer to the PEI Services Table published by the PEI Foundation. |
| [in] | This | A pointer to the EFI_PEI_MP_SERVICES_PPI instance. |
| [in] | ProcessorNumber | The handle number of the AP. The range is from 0 to the total number of logical processors minus 1. The total number of logical processors can be retrieved by EFI_PEI_MP_SERVICES_PPI.GetNumberOfProcessors(). |
| [in] | EnableOldBSP | If TRUE, then the old BSP will be listed as an enabled AP. Otherwise, it will be disabled. |
| EFI_SUCCESS | BSP successfully switched. |
| EFI_UNSUPPORTED | Switching the BSP cannot be completed prior to this service returning. |
| EFI_UNSUPPORTED | Switching the BSP is not supported. |
| EFI_DEVICE_ERROR | The calling processor is an AP. |
| EFI_NOT_FOUND | The processor with the handle specified by ProcessorNumber does not exist. |
| EFI_INVALID_PARAMETER | ProcessorNumber specifies the current BSP or a disabled AP. |
| EFI_NOT_READY | The specified AP is busy. |
Definition at line 192 of file MpServices.h.
| typedef EFI_STATUS(EFIAPI * EFI_PEI_MP_SERVICES_WHOAMI) (IN CONST EFI_PEI_SERVICES **PeiServices, IN EFI_PEI_MP_SERVICES_PPI *This, OUT UINTN *ProcessorNumber) |
Identify the currently executing processor.
| [in] | PeiServices | An indirect pointer to the PEI Services Table published by the PEI Foundation. |
| [in] | This | A pointer to the EFI_PEI_MP_SERVICES_PPI instance. |
| [out] | ProcessorNumber | The handle number of the AP. The range is from 0 to the total number of logical processors minus 1. The total number of logical processors can be retrieved by EFI_PEI_MP_SERVICES_PPI.GetNumberOfProcessors(). |
| EFI_SUCCESS | The current processor handle number was returned in ProcessorNumber. |
| EFI_INVALID_PARAMETER | ProcessorNumber is NULL. |
Definition at line 254 of file MpServices.h.
1.9.6