by a UEFI Driver in its Start() function. This protocol allows the driver to receive \r
configuration information as part of being started.\r
\r
- Copyright (c) 2006 - 2009, Intel Corporation \r
- All rights reserved. This program and the accompanying materials \r
+ Copyright (c) 2006 - 2016, Intel Corporation. All rights reserved.<BR>\r
+ This program and the accompanying materials \r
are licensed and made available under the terms and conditions of the BSD License \r
which accompanies this distribution. The full text of the license may be found at \r
http://opensource.org/licenses/bsd-license.php \r
returned by the platform, and calls Response passing in the\r
arguments returned from Query. The Instance value passed into\r
Response must be the same value passed into the corresponding\r
- call to Query.\r
+ call to Query. The UEFI driver must continuously call Query and\r
+ Response until EFI_NOT_FOUND is returned by Query.\r
+ If the UEFI driver does not recognize the ParameterTypeGuid, it\r
+ calls Response with a ConfigurationAction of\r
+ EfiPlatformConfigurationActionUnsupportedGuid. The UEFI driver\r
+ must then continue calling Query and Response until EFI_NOT_FOUND\r
+ is returned by Query. This gives the platform an opportunity to\r
+ pass additional configuration settings using a different\r
+ ParameterTypeGuid that may be supported by the driver.\r
An Instance value of zero means return the first ParameterBlock\r
in the set of unprocessed parameter blocks. The driver should\r
increment the Instance value by one for each successive call to Query.\r
may be different for different\r
protocols. UEFI driver decodes this\r
structure and its contents based on\r
- ProtocolGuid. ParameterBlock is\r
+ ParameterTypeGuid. ParameterBlock is\r
allocated by the platform and the\r
platform is responsible for freeing\r
the ParameterBlock after Result is\r
\r
@retval EFI_NOT_FOUND No more unread Instance exists.\r
\r
- @retval EFI_INVALID_PARAMETER ControllerHandle is not a valid\r
- EFI_HANDLE.\r
+ @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.\r
\r
@retval EFI_INVALID_PARAMETER Instance is NULL.\r
\r
/// after ControllerHandle is stopped. \r
/// \r
EfiPlatformConfigurationActionNvramFailed = 4,\r
+\r
+ ///\r
+ /// The controller specified by ControllerHandle is still\r
+ /// in a usable state; its configuration has not been updated\r
+ /// via parsing the ParameterBlock. The driver did not support\r
+ /// the ParameterBlock format identified by ParameterTypeGuid.\r
+ /// No actions are required before this controller can be used\r
+ /// again. On additional Query calls from this ControllerHandle,\r
+ /// the platform should stop returning a ParameterBlock\r
+ /// qualified by this same ParameterTypeGuid. If no other\r
+ /// ParameterTypeGuid is supported by the platform, Query\r
+ /// should return EFI_NOT_FOUND.\r
+ ///\r
+ EfiPlatformConfigurationActionUnsupportedGuid = 5,\r
EfiPlatformConfigurationActionMaximum\r
} EFI_PLATFORM_CONFIGURATION_ACTION;\r
\r
\r
@retval EFI_NOT_FOUND Instance was not found.\r
\r
- @retval EFI_INVALID_PARAMETER ControllerHandle is not a valid EFI_HANDLE.\r
+ @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.\r
\r
@retval EFI_INVALID_PARAMETER Instance is zero.\r
\r
used.\r
**/\r
typedef struct {\r
- CHAR8 *CLPCommand; ///< A pointer to the DMTF SM CLP command line null-terminated string that the \r
- ///< driver is required to parse and process when this function is called. \r
+ CHAR8 *CLPCommand; ///< A pointer to the null-terminated UTF-8 string that specifies the DMTF SM CLP command\r
+ ///< line that the driver is required to parse and process when this 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
UINT32 CLPCommandLength; ///< The length of the CLP Command in bytes.\r
- CHAR8 *CLPReturnString; ///< 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
+ CHAR8 *CLPReturnString; ///< A pointer to the null-terminated UTF-8 string that indicates the CLP return status\r
+ ///< that the driver is required to provide to the calling agent.\r
+ ///< 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
projects / mirror_edk2.git / blobdiff