IN OUT UINTN *ParameterBlockSize\r
);\r
\r
-/**\r
-\r
- @param EfiPlatformConfigurationActionNone\r
- The controller specified by ControllerHandle is still\r
- in a usable state, it's configuration has been updated\r
- via parsing the ParameterBlock. If required by the\r
- parameter block and the module supports an NVRAM store\r
- the configuration information from PB was successfully\r
- saved to the NVRAM. No actions are required before\r
- this controller can be used again with the updated\r
- configuration settings.\r
-\r
-\r
- @param EfiPlatformConfigurationStopController \r
- The driver has detected that the controller specified\r
- by ControllerHandle is not in a usable state, and it\r
- needs to be stopped. The calling agent can use the\r
- DisconnectControservice to perform this operation, and\r
- it should be performed as soon as possible.\r
-\r
- @param EfiPlatformConfigurationRestartController\r
- This controller specified by ControllerHandle needs to\r
- be stopped and restarted before it can be used again.\r
- The calling agent can use the DisconnectController()\r
- and ConnectController() services to perform this\r
- operation. The restart operation can be delayed until\r
- all of the configuratiooptions have been set.\r
-\r
-\r
- @param EfiPlatformConfigurationRestartPlatform\r
- A configuration change has been made that requires the\r
- platform to be restarted before the controller\r
- specified by ControllerHandle can be used again. The\r
- calling agent can use the ResetSystem() services to\r
- perform this operation. The restart operation can be\r
- delayed until all of the configuration options have\r
- been set.\r
-\r
- @param EfiPlatformConfigurationActionNvramFailed \r
- The controller specified by ControllerHandle is still\r
- in a usable state; its configuration has been updated\r
- via parsing the ParameterBlock. The driver tried to\r
- update the driver's private NVRAM store with\r
- information from ParameterBlock and failed. No actions\r
- are required before this controller can be used again\r
- with the updated configuration settings, but these\r
- configuration settings are not guaranteed to persist\r
- after ControllerHandle is stopped.\r
-\r
-**/\r
typedef enum {\r
+ ///\r
+ /// The controller specified by ControllerHandle is still\r
+ /// in a usable state, it's configuration has been updated\r
+ /// via parsing the ParameterBlock. If required by the\r
+ /// parameter block and the module supports an NVRAM store\r
+ /// the configuration information from PB was successfully\r
+ /// saved to the NVRAM. No actions are required before\r
+ /// this controller can be used again with the updated\r
+ /// configuration settings.\r
+ ///\r
EfiPlatformConfigurationActionNone = 0,\r
+ \r
+ ///\r
+ /// The driver has detected that the controller specified\r
+ /// by ControllerHandle is not in a usable state, and it\r
+ /// needs to be stopped. The calling agent can use the\r
+ /// DisconnectControservice to perform this operation, and\r
+ /// it should be performed as soon as possible. \r
+ ///\r
EfiPlatformConfigurationActionStopController = 1,\r
+ \r
+ ///\r
+ /// This controller specified by ControllerHandle needs to\r
+ /// be stopped and restarted before it can be used again.\r
+ /// The calling agent can use the DisconnectController()\r
+ /// and ConnectController() services to perform this\r
+ /// operation. The restart operation can be delayed until\r
+ /// all of the configuratiooptions have been set. \r
+ ///\r
EfiPlatformConfigurationActionRestartController = 2,\r
+ \r
+ ///\r
+ /// A configuration change has been made that requires the\r
+ /// platform to be restarted before the controller\r
+ /// specified by ControllerHandle can be used again. The\r
+ /// calling agent can use the ResetSystem() services to\r
+ /// perform this operation. The restart operation can be\r
+ /// delayed until all of the configuration options have\r
+ /// been set. \r
+ ///\r
EfiPlatformConfigurationActionRestartPlatform = 3,\r
+\r
+ ///\r
+ /// The controller specified by ControllerHandle is still\r
+ /// in a usable state; its configuration has been updated\r
+ /// via parsing the ParameterBlock. The driver tried to\r
+ /// update the driver's private NVRAM store with\r
+ /// information from ParameterBlock and failed. No actions\r
+ /// are required before this controller can be used again\r
+ /// with the updated configuration settings, but these\r
+ /// configuration settings are not guaranteed to persist\r
+ /// after ControllerHandle is stopped. \r
+ /// \r
EfiPlatformConfigurationActionNvramFailed = 4,\r
EfiPlatformConfigurationActionMaximum\r
} EFI_PLATFORM_CONFIGURATION_ACTION;\r
versions of the DMTF SM CLP Specification require changes to the\r
parameter block definition, newer ParameterTypeGuid will be\r
used.\r
-\r
- @param CLPCommand A pointer to the DMTF SM CLP command line\r
- null-terminated string that the driver is\r
- required to parse and process when this\r
- EFI_SUCCESS The platform return parameter\r
- information for ControllerHandle.\r
- EFI_NOT_FOUND Instance was not found.\r
- EFI_INVALID_PARAMETER ControllerHandle is\r
- not a valid EFI_HANDLE.\r
- EFI_INVALID_PARAMETER Instance is zero.\r
- function is called. See the DMTF SM CLP\r
- Specification 1.0 Final Standard for\r
- details on the format and syntax of the\r
- CLP command line string. CLPCommand buffer\r
- is allocated by the producer of the\r
- EFI_PLATFORM_TO_DRIVER_CONFIGURATION_PROTOOL.\r
-\r
- @param CLPCommandLength The length of the CLP Command in bytes.\r
-\r
- @param CLPReturnString A pointer to the CLP return status\r
- string that the driver is required to\r
- provide to the calling agent. The\r
- calling agent may parse and/ or pass\r
- this for processing and user feedback.\r
- The SM CLP Command Response string\r
- buffer is filled in by the UEFI driver\r
- in the "keyword=value" format\r
- described in the SM CLP Specification,\r
- unless otherwise requested via the SM\r
- CLP Coutput option in the Command Line\r
- string buffer. UEFI driver's support\r
- for this default "keyword=value"\r
- output format is required if the UEFI\r
- driver supports this protocol, while\r
- support for other SM CLP output\r
- formats is optional (the UEFI Driver\r
- should return an EFI_UNSUPPORTED if\r
- the SM CLP Coutput option requested by\r
- the caller is not supported by the\r
- UEFI Driver). CLPReturnString buffer\r
- is allocated by the consumer of the\r
- EFI_PLATFORM_TO_DRIVER_CONFIGURATION_PROTOC\r
- OL and undefined prior to the call to\r
- Response().\r
-\r
- @param CLPReturnStringLength The length of the CLP return\r
- status string in bytes.\r
-\r
- @param CLPReturnStatus SM CLP Command Status (see DMTF SM CLP\r
- Specification 1.0 Final Standard -\r
- Table 4) CLPErrorValue SM CLP\r
- Processing Error Value (see DMTF SM\r
- CLP Specification 1.0 Final Standard -\r
- Table 6). This field is filled in by\r
- the consumer of the\r
- EFI_PLATFORM_TO_DRIVER_CONFIGURATION_PROTOC \r
- OL and undefined prior to the call to\r
- Response().\r
-\r
- @param CLPMessageCode Bit 15: OEM Message Code Flag 0 =\r
- Message Code is an SM CLP Probable\r
- Cause Value. (see SM CLP Specification\r
- Table 11) 1 = Message Code is OEM\r
- Specific Bits 14-0: Message Code This\r
- field is filled in by the consumer of\r
- the\r
- EFI_PLATFORM_TO_DRIVER_CONFIGURATION_PROTOC\r
- OL and undefined prior to the call to\r
- Response().\r
-\r
**/\r
typedef struct {\r
+ ///\r
+ /// A pointer to the DMTF SM CLP command line null-terminated string that the \r
+ /// driver is required to parse and process when this EFI_SUCCESS The platform \r
+ /// return parameter information for ControllerHandle. EFI_NOT_FOUND Instance \r
+ /// was not found. EFI_INVALID_PARAMETER ControllerHandle is not a valid \r
+ /// EFI_HANDLE. EFI_INVALID_PARAMETER Instance is zero. function is called. \r
+ /// See the DMTF SM CLP Specification 1.0 Final Standard for details on the \r
+ /// format and syntax of the CLP command line string. CLPCommand buffer\r
+ /// is allocated by the producer of the EFI_PLATFORM_TO_DRIVER_CONFIGURATION_PROTOOL.\r
+ ///\r
CHAR8 *CLPCommand;\r
+ \r
+ ///\r
+ /// The length of the CLP Command in bytes.\r
+ ///\r
UINT32 CLPCommandLength;\r
+ \r
+ ///\r
+ /// A pointer to the CLP return status string that the driver is required to\r
+ /// provide to the calling agent. The calling agent may parse and/ or pass\r
+ /// this for processing and user feedback. The SM CLP Command Response string\r
+ /// buffer is filled in by the UEFI driver in the "keyword=value" format\r
+ /// described in the SM CLP Specification, unless otherwise requested via the SM\r
+ /// CLP Coutput option in the Command Line string buffer. UEFI driver's support\r
+ /// for this default "keyword=value" output format is required if the UEFI\r
+ /// driver supports this protocol, while support for other SM CLP output\r
+ /// formats is optional (the UEFI Driver should return an EFI_UNSUPPORTED if\r
+ /// the SM CLP Coutput option requested by the caller is not supported by the\r
+ /// UEFI Driver). CLPReturnString buffer is allocated by the consumer of the\r
+ /// EFI_PLATFORM_TO_DRIVER_CONFIGURATION_PROTOC OL and undefined prior to the call to\r
+ /// Response(). \r
+ ///\r
CHAR8 *CLPReturnString;\r
+ \r
+ ///\r
+ /// The length of the CLP return status string in bytes.\r
+ ///\r
UINT32 CLPReturnStringLength;\r
+ \r
+ ///\r
+ /// SM CLP Command Status (see DMTF SM CLP Specification 1.0 Final Standard -\r
+ /// Table 4) CLPErrorValue SM CLP Processing Error Value (see DMTF SM\r
+ /// CLP Specification 1.0 Final Standard - Table 6). This field is filled in by\r
+ /// the consumer of the EFI_PLATFORM_TO_DRIVER_CONFIGURATION_PROTOC \r
+ /// OL and undefined prior to the call to Response(). \r
+ ///\r
UINT8 CLPCmdStatus;\r
UINT8 CLPErrorValue;\r
+ \r
+ ///\r
+ /// Bit 15: OEM Message Code Flag 0 = Message Code is an SM CLP Probable\r
+ /// Cause Value. (see SM CLP Specification Table 11) 1 = Message Code is OEM\r
+ /// Specific Bits 14-0: Message Code This field is filled in by the consumer of\r
+ /// the EFI_PLATFORM_TO_DRIVER_CONFIGURATION_PROTOC OL and undefined prior to the call to\r
+ /// Response(). \r
+ /// \r
UINT16 CLPMsgCode;\r
} EFI_CONFIGURE_CLP_PARAMETER_BLK;\r
\r
projects / mirror_edk2.git / blobdiff