Поделиться через


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

Извлекает номер узла 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 [только классические приложения]
целевая платформа Виндоус
Header systemtopologyapi.h (include Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

См. также

GetNumaProximityNode

Поддержка NUMA