16a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu/** @file 26a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu SMBIOS Protocol as defined in PI1.2 Specification VOLUME 5 Standard. 36a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu 46a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu SMBIOS protocol allows consumers to log SMBIOS data records, and enables the producer 56a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu to create the SMBIOS tables for a platform. 66a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu 76a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu This protocol provides an interface to add, remove or discover SMBIOS records. The driver which 86a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu produces this protocol is responsible for creating the SMBIOS data tables and installing the pointer 96a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu to the tables in the EFI System Configuration Table. 106a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu The caller is responsible for only adding SMBIOS records that are valid for the SMBIOS 116a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu MajorVersion and MinorVersion. When an enumerated SMBIOS field's values are 126a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu controlled by the DMTF, new values can be used as soon as they are defined by the DMTF without 136a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu requiring an update to MajorVersion and MinorVersion. 146a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu The SMBIOS protocol can only be called a TPL < TPL_NOTIFY. 156a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu 162002bf5dd56927cbacbc748120bc6f6f2e3fe12clzeng Copyright (c) 2006 - 2011, Intel Corporation. All rights reserved.<BR> 179df063a06aef048c042498e2f542fb693e93493ahhtian This program and the accompanying materials 186a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu are licensed and made available under the terms and conditions of the BSD License 196a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu which accompanies this distribution. The full text of the license may be found at 206a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu http://opensource.org/licenses/bsd-license.php 216a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu 226a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, 236a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. 246a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu 256a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu**/ 266a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu 276a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#ifndef __SMBIOS_PROTOCOL_H__ 286a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define __SMBIOS_PROTOCOL_H__ 296a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu 306a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_PROTOCOL_GUID \ 316a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu { 0x3583ff6, 0xcb36, 0x4940, { 0x94, 0x7e, 0xb9, 0xb3, 0x9f, 0x4a, 0xfa, 0xf7 }} 326a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu 336a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu// 342002bf5dd56927cbacbc748120bc6f6f2e3fe12clzeng// SMBIOS type macros which is according to SMBIOS 2.7 specification. 352002bf5dd56927cbacbc748120bc6f6f2e3fe12clzeng// 366a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_BIOS_INFORMATION 0 376a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_SYSTEM_INFORMATION 1 386a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_BASEBOARD_INFORMATION 2 396a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_SYSTEM_ENCLOSURE 3 406a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_PROCESSOR_INFORMATION 4 416a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_MEMORY_CONTROLLER_INFORMATION 5 426a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_MEMORY_MODULE_INFORMATON 6 436a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_CACHE_INFORMATION 7 446a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_PORT_CONNECTOR_INFORMATION 8 456a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_SYSTEM_SLOTS 9 466a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_ONBOARD_DEVICE_INFORMATION 10 476a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_OEM_STRINGS 11 486a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_SYSTEM_CONFIGURATION_OPTIONS 12 496a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_BIOS_LANGUAGE_INFORMATION 13 506a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_GROUP_ASSOCIATIONS 14 516a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_SYSTEM_EVENT_LOG 15 526a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_PHYSICAL_MEMORY_ARRAY 16 536a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_MEMORY_DEVICE 17 546a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_32BIT_MEMORY_ERROR_INFORMATION 18 556a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_MEMORY_ARRAY_MAPPED_ADDRESS 19 566a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_MEMORY_DEVICE_MAPPED_ADDRESS 20 576a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_BUILT_IN_POINTING_DEVICE 21 586a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_PORTABLE_BATTERY 22 596a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_SYSTEM_RESET 23 606a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_HARDWARE_SECURITY 24 616a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_SYSTEM_POWER_CONTROLS 25 626a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_VOLTAGE_PROBE 26 636a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_COOLING_DEVICE 27 646a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_TEMPERATURE_PROBE 28 656a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_ELECTRICAL_CURRENT_PROBE 29 666a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_OUT_OF_BAND_REMOTE_ACCESS 30 676a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_BOOT_INTEGRITY_SERVICE 31 686a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_SYSTEM_BOOT_INFORMATION 32 696a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_64BIT_MEMORY_ERROR_INFORMATION 33 706a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_MANAGEMENT_DEVICE 34 716a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_MANAGEMENT_DEVICE_COMPONENT 35 726a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_MANAGEMENT_DEVICE_THRESHOLD_DATA 36 736a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_MEMORY_CHANNEL 37 746a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_IPMI_DEVICE_INFORMATION 38 756a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_SYSTEM_POWER_SUPPLY 39 762002bf5dd56927cbacbc748120bc6f6f2e3fe12clzeng#define EFI_SMBIOS_TYPE_ADDITIONAL_INFORMATION 40 772002bf5dd56927cbacbc748120bc6f6f2e3fe12clzeng#define EFI_SMBIOS_TYPE_ONBOARD_DEVICES_EXTENDED_INFORMATION 41 782002bf5dd56927cbacbc748120bc6f6f2e3fe12clzeng#define EFI_SMBIOS_TYPE_MANAGEMENT_CONTROLLER_HOST_INTERFACE 42 796a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_INACTIVE 126 806a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_TYPE_END_OF_TABLE 127 816a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_OEM_BEGIN 128 826a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#define EFI_SMBIOS_OEM_END 255 836a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu 846a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu/// 856a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu/// Text strings associated with a given SMBIOS structure are returned in the dmiStrucBuffer, appended directly after 866a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu/// the formatted portion of the structure. This method of returning string information eliminates the need for 876a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu/// application software to deal with pointers embedded in the SMBIOS structure. Each string is terminated with a null 886a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu/// (00h) BYTE and the set of strings is terminated with an additional null (00h) BYTE. When the formatted portion of 89176648481e5f5edd4cb2770ff7cd25dc8dd426c5qhuang/// a SMBIOS structure references a string, it does so by specifying a non-zero string number within the structure's 906a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu/// string-set. For example, if a string field contains 02h, it references the second string following the formatted portion 916a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu/// of the SMBIOS structure. If a string field references no string, a null (0) is placed in that string field. If the 926a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu/// formatted portion of the structure contains string-reference fields and all the string fields are set to 0 (no string 936a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu/// references), the formatted section of the structure is followed by two null (00h) BYTES. 946a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu/// 956a0cd52dc22f0c7b4fa694cda02f4d4adced637cklutypedef UINT8 EFI_SMBIOS_STRING; 966a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu 976a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu/// 986a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu/// Types 0 through 127 (7Fh) are reserved for and defined by this 996a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu/// specification. Types 128 through 256 (80h to FFh) are available for system- and OEM-specific information. 1006a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu/// 1016a0cd52dc22f0c7b4fa694cda02f4d4adced637cklutypedef UINT8 EFI_SMBIOS_TYPE; 1026a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu 1036a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu/// 104176648481e5f5edd4cb2770ff7cd25dc8dd426c5qhuang/// Specifies the structure's handle, a unique 16-bit number in the range 0 to 0FFFEh (for version 1056a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu/// 2.0) or 0 to 0FEFFh (for version 2.1 and later). The handle can be used with the Get SMBIOS 1066a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu/// Structure function to retrieve a specific structure; the handle numbers are not required to be 1076a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu/// contiguous. For v2.1 and later, handle values in the range 0FF00h to 0FFFFh are reserved for 1086a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu/// use by this specification. 1096a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu/// If the system configuration changes, a previously assigned handle might no longer exist. 1106a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu/// However once a handle has been assigned by the BIOS, the BIOS cannot re-assign that handle 1116a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu/// number to another structure. 1126a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu/// 1136a0cd52dc22f0c7b4fa694cda02f4d4adced637cklutypedef UINT16 EFI_SMBIOS_HANDLE; 1146a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu 1156a0cd52dc22f0c7b4fa694cda02f4d4adced637cklutypedef struct { 1166a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu EFI_SMBIOS_TYPE Type; 1176a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu UINT8 Length; 1186a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu EFI_SMBIOS_HANDLE Handle; 1196a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu} EFI_SMBIOS_TABLE_HEADER; 1206a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu 1216a0cd52dc22f0c7b4fa694cda02f4d4adced637cklutypedef struct _EFI_SMBIOS_PROTOCOL EFI_SMBIOS_PROTOCOL; 1226a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu 1236a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu/** 1246a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu Add an SMBIOS record. 1256a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu 1266a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu This function allows any agent to add SMBIOS records. The caller is responsible for ensuring 1276a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu Record is formatted in a way that matches the version of the SMBIOS specification as defined in 1286a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu the MajorRevision and MinorRevision fields of the EFI_SMBIOS_PROTOCOL. 1296a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu Record must follow the SMBIOS structure evolution and usage guidelines in the SMBIOS 1306a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu specification. Record starts with the formatted area of the SMBIOS structure and the length is 1316a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu defined by EFI_SMBIOS_TABLE_HEADER.Length. Each SMBIOS structure is terminated by a 1326a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu double-null (0x0000), either directly following the formatted area (if no strings are present) or 1336a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu directly following the last string. The number of optional strings is not defined by the formatted area, 1346a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu but is fixed by the call to Add(). A string can be a place holder, but it must not be a NULL string as 1356a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu two NULL strings look like the double-null that terminates the structure. 1366a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu 1376a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu @param[in] This The EFI_SMBIOS_PROTOCOL instance. 1386a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu @param[in] ProducerHandle The handle of the controller or driver associated with the SMBIOS information. NULL means no handle. 139eb2423c9ee10b31d6ff4d34761a083df0486c5b8lzeng @param[in, out] SmbiosHandle On entry, the handle of the SMBIOS record to add. If FFFEh, then a unique handle 140eb2423c9ee10b31d6ff4d34761a083df0486c5b8lzeng will be assigned to the SMBIOS record. If the SMBIOS handle is already in use, 1416a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu EFI_ALREADY_STARTED is returned and the SMBIOS record is not updated. 1426a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu @param[in] Record The data for the fixed portion of the SMBIOS record. The format of the record is 1436a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu determined by EFI_SMBIOS_TABLE_HEADER.Type. The size of the formatted 1446a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu area is defined by EFI_SMBIOS_TABLE_HEADER.Length and either followed 1456a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu by a double-null (0x0000) or a set of null terminated strings and a null. 1466a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu 1476a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu @retval EFI_SUCCESS Record was added. 1486a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu @retval EFI_OUT_OF_RESOURCES Record was not added. 1496a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu @retval EFI_ALREADY_STARTED The SmbiosHandle passed in was already in use. 1506a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu**/ 1516a0cd52dc22f0c7b4fa694cda02f4d4adced637cklutypedef 1526a0cd52dc22f0c7b4fa694cda02f4d4adced637ckluEFI_STATUS 1536a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu(EFIAPI *EFI_SMBIOS_ADD)( 1546a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu IN CONST EFI_SMBIOS_PROTOCOL *This, 1553e22fec9612a106e11df03acab38b2efe286e992klu IN EFI_HANDLE ProducerHandle OPTIONAL, 1566a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu IN OUT EFI_SMBIOS_HANDLE *SmbiosHandle, 1576a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu IN EFI_SMBIOS_TABLE_HEADER *Record 1586a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu); 1596a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu 1606a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu/** 1616a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu Update the string associated with an existing SMBIOS record. 1626a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu 1636a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu This function allows the update of specific SMBIOS strings. The number of valid strings for any 1646a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu SMBIOS record is defined by how many strings were present when Add() was called. 1656a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu 1666a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu @param[in] This The EFI_SMBIOS_PROTOCOL instance. 1676a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu @param[in] SmbiosHandle SMBIOS Handle of structure that will have its string updated. 1686a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu @param[in] StringNumber The non-zero string number of the string to update. 1696a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu @param[in] String Update the StringNumber string with String. 1706a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu 1716a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu @retval EFI_SUCCESS SmbiosHandle had its StringNumber String updated. 1726a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu @retval EFI_INVALID_PARAMETER SmbiosHandle does not exist. 173eb2423c9ee10b31d6ff4d34761a083df0486c5b8lzeng @retval EFI_UNSUPPORTED String was not added because it is longer than the SMBIOS Table supports. 1746a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu @retval EFI_NOT_FOUND The StringNumber.is not valid for this SMBIOS record. 1756a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu**/ 1766a0cd52dc22f0c7b4fa694cda02f4d4adced637cklutypedef 1776a0cd52dc22f0c7b4fa694cda02f4d4adced637ckluEFI_STATUS 1786a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu(EFIAPI *EFI_SMBIOS_UPDATE_STRING)( 1796a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu IN CONST EFI_SMBIOS_PROTOCOL *This, 1806a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu IN EFI_SMBIOS_HANDLE *SmbiosHandle, 1816a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu IN UINTN *StringNumber, 1826a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu IN CHAR8 *String 1836a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu); 1846a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu 1856a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu/** 1866a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu Remove an SMBIOS record. 1876a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu 1886a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu This function removes an SMBIOS record using the handle specified by SmbiosHandle. 1896a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu 1906a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu @param[in] This The EFI_SMBIOS_PROTOCOL instance. 1916a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu @param[in] SmbiosHandle The handle of the SMBIOS record to remove. 1926a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu 1936a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu @retval EFI_SUCCESS SMBIOS record was removed. 1946a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu @retval EFI_INVALID_PARAMETER SmbiosHandle does not specify a valid SMBIOS record. 1956a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu**/ 1966a0cd52dc22f0c7b4fa694cda02f4d4adced637cklutypedef 1976a0cd52dc22f0c7b4fa694cda02f4d4adced637ckluEFI_STATUS 1986a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu(EFIAPI *EFI_SMBIOS_REMOVE)( 1996a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu IN CONST EFI_SMBIOS_PROTOCOL *This, 2006a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu IN EFI_SMBIOS_HANDLE SmbiosHandle 2016a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu); 2026a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu 2036a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu/** 2046a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu Allow the caller to discover all or some of the SMBIOS records. 2056a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu 2066a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu This function allows all of the SMBIOS records to be discovered. It's possible to find 2076a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu only the SMBIOS records that match the optional Type argument. 2086a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu 2096a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu @param[in] This The EFI_SMBIOS_PROTOCOL instance. 2106a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu @param[in, out] SmbiosHandle On entry, points to the previous handle of the SMBIOS record. On exit, points to the 211eb2423c9ee10b31d6ff4d34761a083df0486c5b8lzeng next SMBIOS record handle. If it is FFFEh on entry, then the first SMBIOS record 212eb2423c9ee10b31d6ff4d34761a083df0486c5b8lzeng handle will be returned. If it returns FFFEh on exit, then there are no more SMBIOS records. 2136a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu @param[in] Type On entry, it points to the type of the next SMBIOS record to return. If NULL, it 2146a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu indicates that the next record of any type will be returned. Type is not 2156a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu modified by the this function. 2166a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu @param[out] Record On exit, points to a pointer to the the SMBIOS Record consisting of the formatted area 2176a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu followed by the unformatted area. The unformatted area optionally contains text strings. 2186a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu @param[out] ProducerHandle On exit, points to the ProducerHandle registered by Add(). If no 2196a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu ProducerHandle was passed into Add() NULL is returned. If a NULL pointer is 2206a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu passed in no data will be returned. 2216a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu @retval EFI_SUCCESS SMBIOS record information was successfully returned in Record. 2226a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu SmbiosHandle is the handle of the current SMBIOS record 2236a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu @retval EFI_NOT_FOUND The SMBIOS record with SmbiosHandle was the last available record. 2246a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu**/ 2256a0cd52dc22f0c7b4fa694cda02f4d4adced637cklutypedef 2266a0cd52dc22f0c7b4fa694cda02f4d4adced637ckluEFI_STATUS 2276a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu(EFIAPI *EFI_SMBIOS_GET_NEXT)( 2286a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu IN CONST EFI_SMBIOS_PROTOCOL *This, 2296a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu IN OUT EFI_SMBIOS_HANDLE *SmbiosHandle, 2303e22fec9612a106e11df03acab38b2efe286e992klu IN EFI_SMBIOS_TYPE *Type OPTIONAL, 2316a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu OUT EFI_SMBIOS_TABLE_HEADER **Record, 2323e22fec9612a106e11df03acab38b2efe286e992klu OUT EFI_HANDLE *ProducerHandle OPTIONAL 2336a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu); 2346a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu 2356a0cd52dc22f0c7b4fa694cda02f4d4adced637cklustruct _EFI_SMBIOS_PROTOCOL { 2366a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu EFI_SMBIOS_ADD Add; 2376a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu EFI_SMBIOS_UPDATE_STRING UpdateString; 2386a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu EFI_SMBIOS_REMOVE Remove; 2396a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu EFI_SMBIOS_GET_NEXT GetNext; 2406a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu UINT8 MajorVersion; ///< The major revision of the SMBIOS specification supported. 2416a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu UINT8 MinorVersion; ///< The minor revision of the SMBIOS specification supported. 2426a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu}; 2436a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu 2446a0cd52dc22f0c7b4fa694cda02f4d4adced637ckluextern EFI_GUID gEfiSmbiosProtocolGuid; 2456a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu 2466a0cd52dc22f0c7b4fa694cda02f4d4adced637cklu#endif // __SMBIOS_PROTOCOL_H__ 247