/** @file\r
SMBIOS Protocol as defined in PI1.2 Specification VOLUME 5 Standard.\r
\r
- SMBIOS protocol allows consumers to log SMBIOS data records, and enables the producer \r
+ SMBIOS protocol allows consumers to log SMBIOS data records, and enables the producer\r
to create the SMBIOS tables for a platform.\r
\r
This protocol provides an interface to add, remove or discover SMBIOS records. The driver which\r
requiring an update to MajorVersion and MinorVersion.\r
The SMBIOS protocol can only be called a TPL < TPL_NOTIFY.\r
\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
+ Copyright (c) 2006 - 2018, 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
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
**/\r
\r
typedef SMBIOS_TYPE EFI_SMBIOS_TYPE;\r
typedef SMBIOS_HANDLE EFI_SMBIOS_HANDLE;\r
typedef SMBIOS_STRUCTURE EFI_SMBIOS_TABLE_HEADER;\r
- \r
+\r
typedef struct _EFI_SMBIOS_PROTOCOL EFI_SMBIOS_PROTOCOL;\r
\r
/**\r
Add an SMBIOS record.\r
- \r
+\r
This function allows any agent to add SMBIOS records. The caller is responsible for ensuring\r
Record is formatted in a way that matches the version of the SMBIOS specification as defined in\r
the MajorRevision and MinorRevision fields of the EFI_SMBIOS_PROTOCOL.\r
directly following the last string. The number of optional strings is not defined by the formatted area,\r
but is fixed by the call to Add(). A string can be a place holder, but it must not be a NULL string as\r
two NULL strings look like the double-null that terminates the structure.\r
- \r
+\r
@param[in] This The EFI_SMBIOS_PROTOCOL instance.\r
@param[in] ProducerHandle The handle of the controller or driver associated with the SMBIOS information. NULL means no handle.\r
@param[in, out] SmbiosHandle On entry, the handle of the SMBIOS record to add. If FFFEh, then a unique handle\r
determined by EFI_SMBIOS_TABLE_HEADER.Type. The size of the formatted\r
area is defined by EFI_SMBIOS_TABLE_HEADER.Length and either followed\r
by a double-null (0x0000) or a set of null terminated strings and a null.\r
- \r
+\r
@retval EFI_SUCCESS Record was added.\r
@retval EFI_OUT_OF_RESOURCES Record was not added.\r
@retval EFI_ALREADY_STARTED The SmbiosHandle passed in was already in use.\r
\r
/**\r
Update the string associated with an existing SMBIOS record.\r
- \r
+\r
This function allows the update of specific SMBIOS strings. The number of valid strings for any\r
SMBIOS record is defined by how many strings were present when Add() was called.\r
- \r
+\r
@param[in] This The EFI_SMBIOS_PROTOCOL instance.\r
@param[in] SmbiosHandle SMBIOS Handle of structure that will have its string updated.\r
@param[in] StringNumber The non-zero string number of the string to update.\r
@param[in] String Update the StringNumber string with String.\r
- \r
+\r
@retval EFI_SUCCESS SmbiosHandle had its StringNumber String updated.\r
@retval EFI_INVALID_PARAMETER SmbiosHandle does not exist.\r
@retval EFI_UNSUPPORTED String was not added because it is longer than the SMBIOS Table supports.\r
- @retval EFI_NOT_FOUND The StringNumber.is not valid for this SMBIOS record. \r
+ @retval EFI_NOT_FOUND The StringNumber.is not valid for this SMBIOS record.\r
**/\r
typedef\r
EFI_STATUS\r
\r
/**\r
Remove an SMBIOS record.\r
- \r
+\r
This function removes an SMBIOS record using the handle specified by SmbiosHandle.\r
- \r
+\r
@param[in] This The EFI_SMBIOS_PROTOCOL instance.\r
@param[in] SmbiosHandle The handle of the SMBIOS record to remove.\r
- \r
+\r
@retval EFI_SUCCESS SMBIOS record was removed.\r
@retval EFI_INVALID_PARAMETER SmbiosHandle does not specify a valid SMBIOS record.\r
**/\r
\r
/**\r
Allow the caller to discover all or some of the SMBIOS records.\r
- \r
+\r
This function allows all of the SMBIOS records to be discovered. It's possible to find\r
only the SMBIOS records that match the optional Type argument.\r
- \r
+\r
@param[in] This The EFI_SMBIOS_PROTOCOL instance.\r
@param[in, out] SmbiosHandle On entry, points to the previous handle of the SMBIOS record. On exit, points to the\r
next SMBIOS record handle. If it is FFFEh on entry, then the first SMBIOS record\r
UINT8 MajorVersion; ///< The major revision of the SMBIOS specification supported.\r
UINT8 MinorVersion; ///< The minor revision of the SMBIOS specification supported.\r
};\r
- \r
+\r
extern EFI_GUID gEfiSmbiosProtocolGuid;\r
- \r
+\r
#endif // __SMBIOS_PROTOCOL_H__\r
projects / mirror_edk2.git / blobdiff