Memory Vendor Info Extension

Introduced in Level Zero version 1.18

API

• Enumerations

  • zes_memory_vendor_info_ext_version_t

• Structures

  • zes_memory_vendor_info_ext_properties_t

• Macros

  • ZES_MEMORY_VENDOR_INFO_EXT_NAME

  • ZES_MEMORY_VENDOR_NAME_EXT_SIZE

Memory Vendor Info Overview

The Memory Vendor Info extension provides the ability to query the memory vendor ID and the memory vendor name.

Applications can retrieve both the memory vendor ID and the memory vendor name by passing the extension structure via the pNext chain when calling zesMemoryGetProperties. The two are reported independently: if the vendor ID cannot be determined, the vendor ID will be 0, and if the vendor name cannot be determined, the length will be 0 and the name will not be populated.

Checking Extension Support

Query extension support via zesDriverGetExtensionProperties before use:

uint32_t count = 0;
zesDriverGetExtensionProperties(hDriver, &count, NULL);

zes_driver_extension_properties_t* props =
    malloc(count * sizeof(zes_driver_extension_properties_t));
zesDriverGetExtensionProperties(hDriver, &count, props);

bool supported = false;
for (uint32_t i = 0; i < count; i++) {
    if (strcmp(props[i].name, ZES_MEMORY_VENDOR_INFO_EXT_NAME) == 0) {
        supported = true;
        break;
    }
}
free(props);

If the extension is not reported, the driver ignores the extension structure in the pNext chain and the values returned in zes_memory_vendor_info_ext_properties_t are not modified.

Querying the Vendor ID and Vendor Name

The following pseudo-code demonstrates the usage pattern for querying the memory vendor ID and the memory vendor name.

// Query memory properties with memory vendor info extension to retrieve
// both the vendor ID and the vendor name
zes_mem_properties_t memProps = {};
memProps.stype = ZES_STRUCTURE_TYPE_MEM_PROPERTIES;

zes_memory_vendor_info_ext_properties_t vendorInfoProps = {};
vendorInfoProps.stype = ZES_STRUCTURE_TYPE_MEMORY_VENDOR_INFO_EXT_PROPERTIES;
vendorInfoProps.pNext = nullptr;

memProps.pNext = &vendorInfoProps;

zesMemoryGetProperties(hMemory, &memProps);

// Check if vendor ID was successfully retrieved
if (vendorInfoProps.vendorId != 0) {
    output("Memory Vendor ID: 0x%x\n", vendorInfoProps.vendorId);
} else {
    output("Memory vendor ID not available for this device\n");
}

// Check if vendor name was successfully retrieved
if (vendorInfoProps.length != 0) {
    output("Memory Vendor Name: %s\n", vendorInfoProps.vendorName);
    output("Memory Vendor Name Length: %u\n", vendorInfoProps.length);
} else {
    output("Memory vendor name not available for this device\n");
}