dmi_memory_array
Synopsis
#include <opendmi/entity/memory-array.h>
typedef struct dmi_memory_array {
dmi_memory_array_location_t location;
dmi_memory_array_use_t use;
dmi_error_correct_type_t error_correction;
dmi_size_t maximum_capacity;
dmi_handle_t error_handle;
dmi_entity_t *error_info;
unsigned int device_count;
} dmi_memory_array_t;Description
The dmi_memory_array_t structure holds the decoded physical memory array
structure (type 16) of SMBIOS: a group of memory devices which work together to
make up one memory address space, such as the system memory on the motherboard,
or the memory of an add-on card.
A table has one such structure per memory array. The memory device structures (type 17) of the array and the memory array mapped address structures (type 19) refer to it by its handle. The structure is required since SMBIOS 2.3.
The structure is returned by dmi_entity_info for the structures of type
DMI_TYPE(memory_array), and lives as long as the context it has been decoded
in.
Fields
location-
Where the array resides: on the motherboard, or on an add-on card of some kind. See
dmi_memory_array_location. use-
What the array is used for, e.g. system memory, video memory or flash memory. See
dmi_memory_array_use. error_correction-
Main method of error detection or correction the array supports. See
dmi_error_correct_type. maximum_capacity-
Largest amount of memory the array can hold, in bytes. The structure carries it in kilobytes, or in bytes in an extended field present since SMBIOS 2.7 for the arrays of 2 TiB or more; both are converted to bytes.
DMI_SIZE_MAXif the capacity is unknown, which is the case when the structure points to the extended field and is too short to hold it. error_handle-
Handle of the memory error information structure (type 18 or 33) describing the last error detected in the array.
DMI_HANDLE_INVALIDif no error has been detected, andDMI_HANDLE_UNSUPPORTEDif the system provides no error information. error_info-
Memory error information structure of the array, resolved from
error_handleonce the table has been linked.nullptrif the handle isDMI_HANDLE_INVALIDorDMI_HANDLE_UNSUPPORTED, or does not refer to a memory error information structure. device_count-
Number of the slots or sockets for memory devices the array has, which is the number of the memory device structures belonging to the array, whether the slots are populated or not.
Examples
dmi_registry_t *registry = dmi_get_registry(context);
dmi_entity_t *entity = dmi_registry_lookup_first(registry,
DMI_TYPE(memory_array), false);
dmi_memory_array_t *array = dmi_entity_info(entity,
DMI_TYPE(memory_array));
if ((array != nullptr) && (array->maximum_capacity != DMI_SIZE_MAX))
printf("%u slots, up to %llu bytes\n", array->device_count,
(unsigned long long)array->maximum_capacity);