- Generated on Fri Nov 15 2024 18:01:42 for TianoCore EDK2 by
1.9.6
|
TianoCore EDK2 master
|
#include <Ppi/MpServices.h>Go to the source code of this file.
Data Structures | |
| struct | _EDKII_PEI_MP_SERVICES2_PPI |
Macros | |
| #define | EDKII_PEI_MP_SERVICES2_PPI_GUID |
Variables | |
| EFI_GUID | gEdkiiPeiMpServices2PpiGuid |
This file declares EDKII Multi-processor service PPI.
Copyright (c) 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent
Definition in file MpServices2.h.
| #define EDKII_PEI_MP_SERVICES2_PPI_GUID |
Definition at line 14 of file MpServices2.h.
| typedef struct _EDKII_PEI_MP_SERVICES2_PPI EDKII_PEI_MP_SERVICES2_PPI |
Definition at line 19 of file MpServices2.h.
| typedef EFI_STATUS(EFIAPI * EDKII_PEI_MP_SERVICES_ENABLEDISABLEAP) (IN EDKII_PEI_MP_SERVICES2_PPI *This, IN UINTN ProcessorNumber, IN BOOLEAN EnableAP, IN UINT32 *HealthFlag OPTIONAL) |
Enable or disable an application processor.
| [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 207 of file MpServices2.h.
| typedef EFI_STATUS(EFIAPI * EDKII_PEI_MP_SERVICES_GET_NUMBER_OF_PROCESSORS) (IN EDKII_PEI_MP_SERVICES2_PPI *This, OUT UINTN *NumberOfProcessors, OUT UINTN *NumberOfEnabledProcessors) |
Get the number of CPU's.
| [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 37 of file MpServices2.h.
| typedef EFI_STATUS(EFIAPI * EDKII_PEI_MP_SERVICES_GET_PROCESSOR_INFO) (IN EDKII_PEI_MP_SERVICES2_PPI *This, IN UINTN ProcessorNumber, OUT EFI_PROCESSOR_INFORMATION *ProcessorInfoBuffer) |
Get information on a specific CPU.
| [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 59 of file MpServices2.h.
| typedef EFI_STATUS(EFIAPI * EDKII_PEI_MP_SERVICES_STARTUP_ALL_APS) (IN EDKII_PEI_MP_SERVICES2_PPI *This, IN EFI_AP_PROCEDURE Procedure, IN BOOLEAN SingleThread, IN UINTN TimeoutInMicroSeconds, IN VOID *ProcedureArgument OPTIONAL) |
Activate all of the application proessors.
| [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 99 of file MpServices2.h.
| typedef EFI_STATUS(EFIAPI * EDKII_PEI_MP_SERVICES_STARTUP_ALL_CPUS) (IN EDKII_PEI_MP_SERVICES2_PPI *This, IN EFI_AP_PROCEDURE Procedure, IN UINTN TimeoutInMicroSeconds, IN VOID *ProcedureArgument OPTIONAL) |
Activate all of the application proessors.
| [in] | This | A pointer to the EDKII_PEI_MP_SERVICES2_PPI instance. |
| [in] | Procedure | A pointer to the function to be run on enabled APs of the system. |
| [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 in blocking mode, BSP returns EFI_TIMEOUT. |
| [in] | ProcedureArgument | The parameter passed into Procedure for all CPUs. |
| EFI_SUCCESS | In blocking mode, all APs have finished before the timeout expired. |
| EFI_DEVICE_ERROR | Caller processor is AP. |
| 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 257 of file MpServices2.h.
| typedef EFI_STATUS(EFIAPI * EDKII_PEI_MP_SERVICES_STARTUP_THIS_AP) (IN EDKII_PEI_MP_SERVICES2_PPI *This, IN EFI_AP_PROCEDURE Procedure, IN UINTN ProcessorNumber, IN UINTN TimeoutInMicroseconds, IN VOID *ProcedureArgument OPTIONAL) |
Activate a specific application processor.
| [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 141 of file MpServices2.h.
| typedef EFI_STATUS(EFIAPI * EDKII_PEI_MP_SERVICES_SWITCH_BSP) (IN EDKII_PEI_MP_SERVICES2_PPI *This, IN UINTN ProcessorNumber, IN BOOLEAN EnableOldBSP) |
Switch the boot strap processor.
| [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 173 of file MpServices2.h.
| typedef EFI_STATUS(EFIAPI * EDKII_PEI_MP_SERVICES_WHOAMI) (IN EDKII_PEI_MP_SERVICES2_PPI *This, OUT UINTN *ProcessorNumber) |
Identify the currently executing processor.
| [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 229 of file MpServices2.h.
1.9.6