Функция GetNumaProximityNodeEx (systemtopologyapi.h)

Статья
03/08/2023

Извлекает номер узла NUMA, соответствующий указанному идентификатору близкого взаимодействия в качестве значения USHORT .

Синтаксис

BOOL GetNumaProximityNodeEx(
  [in]  ULONG   ProximityId,
  [out] PUSHORT NodeNumber
);

Параметры

[in] ProximityId

Идентификатор близкого взаимодействия узла.

[out] NodeNumber

Указывает на переменную для получения номера узла для указанного идентификатора близкого взаимодействия.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение.

Идентификатор домена близкого взаимодействия — это индекс узла NUMA в системе NUMA. Идентификаторы доменов близкого взаимодействия находятся в таблице сопоставления системных ресурсов ACPI (SRAT), где они используются для связывания процессоров и регионов памяти с определенным узлом NUMA. Идентификаторы доменов близкого взаимодействия также находятся в пространстве имен ACPI, где они используются для связывания устройства с определенным узлом NUMA. Идентификаторы доменов близкого взаимодействия обычно используются только приложениями управления, предоставляемыми производителями систем. Windows не использует идентификаторы доменов близкого взаимодействия для идентификации узлов NUMA; Вместо этого он назначает уникальный номер каждому узлу NUMA в системе.

Относительное расстояние между узлами в системе хранится в таблице сведений о расположении системы ACPI (SLIT), которая не предоставляется никакими функциями Windows. Дополнительные сведения о таблицах ACPI см. в спецификациях ACPI.

Единственное различие между функцией GetNumaProximityNodeEx и функцией GetNumaProximityNode заключается в типе данных параметра NodeNumber .

Чтобы скомпилировать приложение, использующее эту функцию, задайте _WIN32_WINNT >= 0x0601. Дополнительные сведения см. в разделе Использование заголовков Windows.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	systemtopologyapi.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll

См. также

GetNumaProximityNode

Поддержка NUMA