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 - 2008, Intel Corporation \r
- All rights reserved. This program and the accompanying materials \r
+ Copyright (c) 2006 - 2011, 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
should not attempt to free ParameterTypeGuid.\r
\r
@param ParameterBlock The platform returns a pointer to the\r
- ParameterBlock structure, which\r
+ ParameterBlock structure which\r
contains details about the\r
configuration parameters specific to\r
the ParameterTypeGuid. This structure\r
protocols. UEFI driver decodes this\r
structure and its contents based on\r
ProtocolGuid. ParameterBlock is\r
- allocated by the platform. The\r
+ allocated by the platform and the\r
platform is responsible for freeing\r
the ParameterBlock after Result is\r
called.\r
ParameterTypeGuid. The platform is responsible for freeing\r
ParameterBlock and the UEFI driver must not try to free it.\r
\r
- @param This A pointer to the EFI_PLATFORM_TO_DRIVER_CONFIGURATION_PROTOCOL instance.\r
+ @param This A pointer to the EFI_PLATFORM_TO_DRIVER_CONFIGURATION_PROTOCOL instance.\r
\r
- @param ControllerHandle The handle the driver is returning\r
- configuration information about.\r
+ @param ControllerHandle The handle the driver is returning\r
+ configuration information about.\r
\r
- @param ChildHandle The handle of the child controller to\r
- return information on. This is an optional\r
- parameter that may be NULL. It will be\r
- NULL for device drivers, and for bus\r
- drivers that attempt to get options for\r
- the bus controller. It will not be NULL\r
- for a bus driver that attempts to get\r
- options for one of its child controllers.\r
- Instance Instance data returned from\r
- Query().\r
+ @param ChildHandle The handle of the child controller to\r
+ return information on. This is an optional\r
+ parameter that may be NULL. It will be\r
+ NULL for device drivers, and for bus\r
+ drivers that attempt to get options for\r
+ the bus controller. It will not be NULL\r
+ for a bus driver that attempts to get\r
+ options for one of its child controllers.\r
+ Instance Instance data returned from\r
+ Query().\r
\r
- @param Instance Instance data passed to Query().\r
+ @param Instance Instance data passed to Query().\r
\r
- @param ParameterTypeGuid ParameterTypeGuid returned from Query.\r
+ @param ParameterTypeGuid ParameterTypeGuid returned from Query.\r
\r
- @param ParameterBlock ParameterBlock returned from Query.\r
+ @param ParameterBlock ParameterBlock returned from Query.\r
\r
- @param ParameterBlockSize The ParameterBlock size returned from Query.\r
+ @param ParameterBlockSize The ParameterBlock size returned from Query.\r
\r
- @param ConfigurationAction The driver tells the platform what\r
- action is required for ParameterBlock to\r
- take effect.\r
+ @param ConfigurationAction The driver tells the platform what\r
+ action is required for ParameterBlock to\r
+ take effect.\r
\r
\r
@retval EFI_SUCCESS The platform return parameter information\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. 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
+ 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